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PREFACE 


MANUAL OBJECTIVES 

This manual describes the operation of the Crash Dump Analyzer (CDA). 
It does not attempt to describe the operation of the RSX-llM-PLUS 
Executive or the significance of the individual data structures. The 
RSX-11M/M-PLUS Executive Reference Manual and the RSX-llM and 
RSX-llM-PLUS Guide to Writing an I/O Driver describe these data 
structures. 


INTENDED AUDIENCE 

This manual is intended for system managers who are responsible for 
interpreting system failures and for system operators who run CDA to 
generate dumps. Understanding CDA output requires a working knowledge 
of assembly language programming and the Executive data structures. 


STRUCTURE OF THIS MANUAL 

Chapter 1 explains the function of the Crash Dump Analyzer. It 

describes the system resources necessary and the procedure for 

obtaining a crash dump. The chapter continues with an overview of 
loadable crash dump drivers, and explains how to run CDA. The chapter 
also describes indirect command files as they pertain to CDA. 

Chapter 2 describes the two ways that you can use CDA: by issuing the 

CDA command line or the DCL ANALYZE/CRASH_DUMP command. The chapter 
begins by describing the CDA command line format, including command 
line specifications and switches. Two summary tables provide quick 
reference on switch operation. Finally, the chapter concludes with a 
description of the DCL ANALYZE/CRASH_DUMP command. 

Chapter 3 consists of examples and descriptions of CDA output 
listings. 

Chapter 4 contains helpful hints for interpreting CDA output listings. 

Appendix A contains a short description of each CDA error message. 

Appendix B lists system macros that supply symbolic offsets for system 
data structures for RSX-llM. 

Appendix C lists system macros that supply symbolic offsets for system 
data structures for RSX-llM-PLUS. 

r \ ! 

Appendix D lists error code definitions for Micro/RSX operating 
systems. 
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ASSOCIATED MANUALS 


Refer to the RSX-11M/RSX-11S Information Directory and Index for 
brief description of each manual in the RSX-11M documentation set. 


a 



Refer to the RSX-11M-PLUS Information Directory and Index for a brief 
description of each manual in the RSX-11M-PLUS documentation set. 


CONVENTIONS USED IN THIS MANUAL 


(ret) This symbol indicates that you press the RETURN key. 

[] Square brackets show elements in a command line format 

that are optional. For example, [/switch] indicates 
that you can include a switch if you want to, but you 
do not have to. 




red ink 


Square brackets around a comma and an ellipsis mark 
indicate that you can use a series of optional elements 
separated by commas. For example, (argument[,...]) 
means that you can specify a series of optional 
arguments by enclosing the arguments in parentheses and 
separating them with commas. 


Red ink in the examples of this manual denotes user 
input. 


pink shading Pink shading in this manual indicates features that are 
specific to RSX-11M operating systems only. 


gray shading Gray shading 
RSX-11M-PLUS 


indicates 

operating 


features that 
systems only. 


are specific 


to 
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SUMMARY OF TECHNICAL CHANGES 


TECHNICAL CHANGES 


The system Assign Table, which is one of the report listings 
that CDA generates, has been changed. The table now lists 
logical assignments in two categories: system logical 
assignments, and user logical assignments. The entry in the 
table for each assignment includes its size in blocks, its 
type, and its status. 

Some of the system data structures that are shown in Appendix 
B and Appendix C have changed as a result of new system 
features such as support for logical names and networking. 
Refer to the specific data structures in Appendix B (RSX-11M) 
or Appendix C (RSX-11M-PLUS) to see the changes. 


NEW DEVICE SUPPORT 

You can specify any of the following new devices as the crash dump 
device for your system: 

For RSX-11M/M-PLUS Systems 

Device Type Mnemonic 

RA60/RX50 disk packs DU: 

RC25 removable disk packs DU: 

TK25/TU80 magnetic tapes MS: 

TK50 magnetic tapes MU: 

For Micro/RSX or Pregenerated RSX-11M-PLUS Systems 


Device Type 


Mnemonic 


RD52 

disks 


DU: 

TK25 

magnetic 

tapes 

MS: 

TK50 

magnetic 

tapes 

MU: 


ADDITIONS TO THE CRASH DUMP ANALYZER REFERENCE MANUAL 


The following documentation has been added to this manual: 





Chapter 1 now includes a description of loadable crash dump 
support for Micro/RSX and pregenerated RSX-11M-PLUS systems. 
You load a crash dump driver by specifying a crash dump 
device. If the system crashes when the driver is loaded, the 
driver dumps the contents of memory at the time of the crash 


IX 




SUMMARY OF TECHNICAL CHANGES 


onto the specified crash dump device. When you do not want a 
crash driver resident in memory, you can unload it to the 
system disk. Thus, loadable crash drivers allow you to choose 
when you want crash dump support. 


• Chapter 2 now includes a description of the DCL 
ANALYZE/CRASH_DUMP command. If your terminal supports the 
DIGITAL Command Language (DCL) command line interpreter, you 
can use the ANALYZE/CRASH DUMP command to run CDA. Command 
qualifiers let you choose which report listings you want CDA 
to generate. You can also use qualifiers to specify the 
format of the CDA report listings. 

• A new appendix. Appendix D, lists error code definitions for 
Micro/RSX operating systems, including facility-independent 
definitions and Bugcheck standard format definitions. 
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CHAPTER 1 


INTRODUCTION 


This chapter introduces the Crash Dump Analyzer (CDA) 


It describes 


the function of CDA, details the system features that CDA requires, 
and explains how to obtain a crash dump. The procedures for 
generating a crash dump vary from system to system, 
explains how to obtain a crash dump on different types 


This chapter 
of systems. 


Then this chapter describes how to run CDA, and how to use CDA with 
indirect command files. Finally, the last section of the chapter 
lists the six basic analysis listings that the Crash Dump Analyzer 
generates. 


1.1 CRASH DUMP ANALYZER FUNCTION 

CDA is a specialized utility that helps you establish the cause of 
system crashes. It is installed in a system as a nonprivileged task 
that any user can run. CDA reads the contents of a memory dump 
created by the crash dump routine of the Executive. CDA then uses the 
data in the Executive symbol table file (RSX11M.STB) to format the 
binary input of the memory dump into readable analysis listings. 
Finally, CDA prints the analysis listings on a line printer. 
Examining the CDA listings can help you to determine the cause of a 
system crash. 

CDA is a nonprivileged task that any user can run. 


1.2 SYSTEM REQUIREMENTS 

Micro/RSX operating systems with the Advanced Programmer's Kit and 
pregenerated RSX-11M-PLUS operating systems support loadable crash 
dump drivers. Refer to Section 1.4 for a description of loadable 
crash dump support. 

On RSX-11M operating systems, and on non-pregenerated RSX-11M-PLUS 
operating systems, you can select support for crash dump analysis 
during system generation. Refer to the RSX-11M System Generation and 
Installation Guide or the RSX-11M-PLUS System Generation arid 
Installation Guide for instructions on how to include CDA in your 
system. If you select support for crash dump analysis during system 
generation, you specify a crash notification device and a crash dump 
device. The system then builds a crash dump routine into the 
Executive. Thereafter, when the system crashes, the crash dump 
routine displays a message on the crash notification device and writes 
the contents of memory onto the specified crash dump device. The 
contents of memory are the input to CDA. If you decide to change the 
crash dump or crash notification devices, you must perform another 
system generation in order to specify the new devices. 
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Since CDA overwrites the contents of the crash dump device, you should 
not specify the system device as the crash dump device. Also, the 
following fixed disks cannot serve as CDA crash dump devices: 

RA80 

RA81 

RD51 

RC25 

However, you may use any of the following mass storage devices as the 
crash dump device for your system. 

For RSX—11M/M—PLUS Operating Systems 


Device Mnemonic 

RP04/RP05/RP06 disk packs DB: 

DECtape II (TU58) DD: 

RK05/J/F disk cartridge DK: 

RL01/RL02 disks DL: 

RK06/RK07 disk cartridges DM: 

RM02/RM03/RM05 disk packs DR: 

DECtape (TU56) DT: 

RC25 removable disk pack DU: 

RA60/RX50 disk packs DU: 

RXO1 diskette (RSX-11M only) DX: 

RX02 diskette DY: 

TU45/TU16/TE16/TU77 magnetic tapes MM: 

TS11/TU80/TSV05/TK25 magnetic tapes MS: 

TS03/TU10/TE10 magnetic tapes MT: 

TK50 magnetic tapes MU: 

For Micro/RSX and Pregenerated RSX-11M-PLUS Operating Systems 

Device Mnemonic 

RL01/RL02 disks DL: 

RD51/RD52/RX50 disks DU: 

TSV05/TK25 magnetic tape MS: 

TK50 magnetic tapes MU: 


1.3 OBTAINING A CRASH DUMP 

To obtain a crash dump, control of the processor must be transferred 
to the Executive crash dump routine following a system crash. The 
transfer of processor control depends on how the crash occurred and 
whether you built the Executive Debugging Tool (XDT) into your system 
during system generation. 

System crashes can result from any of the following causes: 

1. The processor encounters a program condition that causes it 
to trap to location 40 or to XDT. 

2. An infinite loop condition occurs. 

3. The processor encounters an unintentional HALT instruction in 
kernel mode (000000). 
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When a program condition causes a processor trap and XDT is included 
in your system, control transfers automatically to XDT. You can then 
type X at the console terminal, and XDT transfers control to the crash 
dump routine. For example: 

XDT> X m 

Refer to the RSX-11M/M-PLUS and Micro/RSX Debugging Reference Manual 
for a description of XDT. 

If your system does not include XDT, a processor trap causes control 
to be transferred directly to the crash dump routine of the Executive. 

When a system crash is the result of a HALT instruction or an infinite 
loop condition, you must restart the processor manually at location 
40. 

Regardless of how control is transferred, once the processor enters 
the crash dump routine, the routine prints the following informational 
message on the crash notification device: 

CRASH-CONT WITH SCRATCH MEDIA ON ddnn 

After displaying the message, the crash dump routine halts the 
processor so you can put the crash dump device on line. When the 
device is on line, restart the processor by depressing the Continue 
switch on the processor console. The crash dump routine then dumps 
memory on the crash dump device and halts the processor when the dump 
finishes. The volume in the crash dump device now contains a binary 
representation of the contents of memory at the time of the crash. 
These contents are the input to CDA. You can then reboot the system 
and run CDA to analyze the dump. 

If you attempt to crash to an illegal device, the crash dump routine 
displays the following message on the crash notification device: 

CRASH — ILLEGAL CRASH DEVICE 

After displaying the message, the crash dump routine halts. The 
illegal crash device error occurs if you specify a fixed media device 
as the crash dump device. If you have a removable media device on the 
same controller, you can switch the physical unit number plugs on the 
devices to assign the removable media device to the crash device. 
Then press the Continue key on the operator*s console and the crash 
dump routine will attempt the dump again. 


1.4 LOADABLE CRASH DUMP DRIVERS 

The pregenerated RSX-11M-PLUS operating system and the Privileged 
Development option of the Micro/RSX Advanced Programmer’s Kit include 
loadable crash dump drivers. Loadable drivers reside on an external 
storage device when they are not in use. Using loadable drivers for 
crash dump support reduces the size of the Executive and frees memory 
space for other purposes. 


1.4.1 Crash Devices 

Loadable crash dump support is provided by four loadable crash dump 
drivers, each of which dumps the contents of memory to a specific type 
of device. The following list shows the crash dump drivers and their 
corresponding device types. 
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Crash Dump Driver 


Crash Dump Device 


DLCRSH.TSK 


RL02 cartridge disk 


DUCRSH.TSK 


RX50 diskette 


MSCRSH.TSK 


TSV05/TK25 magnetic tape 


MUCRSH.TSK 


TK50 magnetic tape(Micro/RSX) 
TK50 magnetic tape(RSX-11M-PLUS) 


If the crash dump driver is loaded and the system crashes, the 
contents of memory are dumped to the designated crash device. You can 
then use the Crash Dump Analyzer to investigate the cause of the 
crash. If there is not a crash driver resident in the system when the 
system crashes, the Bugcheck facility displays the following message: 

SYSTEM FAULT DETECTED AT PC=xxxxxx FACILITY=xxxxxx ERROR CODE=xxxxxx 
CRASH — CRASH DRIVER NOT LOADED 


nnnnnn 


@? 


1.4.2 Loading a Crash Dump Driver 

A loadable crash driver resides on the system disk until you specify a 
crash device. To specify a crash device, use the following command: 

SET SYSTEM /CRASH_DEVICE:ddn: ®) 

This command loads a specific crash driver into a main memory 
partition and updates the crash data base. Also, you may use this 
command to change the crash dump device or to change the unit number 
of the crash device while the system is running. 

When the crash driver is successfully loaded, you receive the 
following message: 

SET — Crash device ddn: has been successfully loaded 

If the device that you specified as the crash device is not in the 
current system, the following error message is displayed: 

SET — Device not in system 

If a crash driver is already loaded and you specify a different device 
with the SET SYSTEM/CRASH_DEVICE command, the system unloads the 
resident crash driver, loads the new driver for the device that you 
specified, and updates the crash data base. If a crash driver is 
loaded and you specify the same device but a different unit number, 
the resident driver remains loaded and the system changes the device 
unit number in the crash data base. 

If you specify the system disk as a crash device, you receive the 
following warning message: 

SET — WARNING, System disk chosen as crash device 
SET — Crash device ddn: has been successfully loaded 
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Note that if your system disk is a removable disk, it is a valid crash 
dump device. The system warns you that you have specified the system 
disk, but it loads the crash dump driver for the disk despite the 
warning message. You should avoid using the system disk as the crash 
dump device, because the memory dump will overwrite the contents of 
the disk, unless you remove the system disk and replace it with a 
scratch disk when the system crashes. 

It is not possible to crash to a fixed media device such as the RD51 
fixed disk. If you indicate the RD51 or any other fixed disk as a 
crash device, you receive the following message: 

CRASH — ILLEGAL CRASH DEVICE 

CRASH — CONT WITH SCRATCH MEDIA ON ddn 

At this point, you cannot obtain a crash dump of memory. 


NOTE 

You cannot select a crash device and unit number once 
the crash has occurred. 


However, you may choose a crash device unit that is not in the current 
system. To do this, specify the address of the control and status 
register (CSR) of the device that you want as the crash device. Use 
the /REGISTER switch to specify the address of the CSR of the desired 
device: 

SET SYSTEM /CRASH_DEVICE :ddn : REGISTER:csraddr ®) 

To display the current crash dump device unit, use the following 
command: 

$ SHOW SYSTEM /CRASH_DEVICE ® 

In response to this command, the system displays the current device 
unit, as follows: 

CRASHDEV=ddn: 


1.4.3 Unloading a Crash Dump Driver 

You use the following command to unload a crash dump driver when crash 
dump support is unnecessary: 

$ SET SYSTEM /NOCRASH_DEVICE (ret) 

In response to this command, the system displays the following 
message: 

SET — Crash device ddn: is being unloaded 
SET -- WARNING, Crash dump support is inactive 

The system then unloads the crash dump driver and updates the crash 
data base. When there is no crash dump driver resident in memory, the 
Bugcheck facility services system crashes (refer to Appendix D for a 
list of error code definitions used by Bugcheck). Unloading the crash 
dump driver frees the memory space in the crash driver partition until 
you decide to reactivate crash dump support. You can reactivate crash 
dump support at any time simply by specifying a new crash device unit. 
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1.4.4 When the System Crashes 

When a Micro/RSX or pregenerated RSX-11M-PLUS operating system 
crashes, the reaction of the system depends on the type of crash 
support that is loaded when the crash occurs. There are three types 
of crash support: 

1. The Bugcheck facility, which is a standard part of the 
operating system, and is therefore resident in memory 

2. Loadable crash dump drivers 

3. XDT, which is also loadable 

Thus, when a system crashes, any of the following conditions may 
exist: 

• A crash dump driver is loaded but XDT is not 

• Both a crash dump driver and XDT are loaded 

• XDT is loaded but a crash dump driver is not 


1.4.4.1 A System Crash with a Driver Loaded and XDT Unloaded - If a 
system crashes when a crash driver is loaded but XDT is not loaded, 
the crash dump routine notifies you of the crash with the following 
message: 

CRASH — CONT WITH SCRATCH MEDIA ON ddn 

After displaying this message, the crash routine halts the hardware 
processor so that you can make sure there is a scratch media in the 
crash device. When you have the crash device ready, press the P key 
followed by a carriage return to proceed. 

In response to your command to proceed, the crash dump routine dumps 
memory to the designated crash dump device. When the dump is 
completed, the processor is again halted. During the memory dump, the 
processor Run light is on; when the dump is completed, the processor 
Run light goes off. 

At this point, the medium in the crash dump device contains a binary 
representation of the contents of memory at the time the system crash 
occurred. This memory dump is the input to CDA. Now you can use the 
ANALYZE/CRASH_DUMP command, which is described in Section 2.2 of this 
manual, to control how CDA processes the crash dump. Then you can 
analyze the output listings that CDA generates to determine why your 
system crashed. 


1.4.4.2 A System Crash with a Driver Loaded and XDT Loaded - If a 
system crashes when a crash driver and XDT are loaded, control is 
transferred to XDT. After you use XDT to debug the system, if you 
want to obtain a crash dump, press the X key followed by a carriage 
return. The following message is then displayed: 

CRASH — CONT WITH SCRATCH MEDIA ON ddn 

Now you can follow the procedure in Section 1.4.4.1 to obtain the 
crash dump. 
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1.4.4.3 A System Crash with only XDT 
when XDT is loaded but a crash 
transferred to XDT. However, when 
following is displayed: 


Loaded - If a system crashes 
driver is not loaded, control is 
you enter the X command, the 


SYSTEM FAULT DETECTED AT PC=xxxxxx FACILITY=xxxxxx ERROR CODE=xxxxxx 
CRASH — CRASH DRIVER NOT LOADED 


1.4.4.4 Inducing a System Crash - In some situations, you may want to 
purposely induce a system crash. Then, if you have a crash driver 
loaded, you can dump the contents of memory and examine them. For 
example, suppose that you want to stop the processor from executing in 
an infinite loop. You can induce a system crash by performing the 
following procedure: 

1. Push the Halt button on the processor. On processors with 
console ODT, the following is displayed: 



2 . 

3. 


nnnnnn 

@ 

Release the Halt button. 

At the terminal, type 40G. The following is displayed: 
CRASH — CONT WITH SCRATCH MEDIA ON ddn 


nnnnnn 

0 


If you have a crash driver loaded, you can obtain a crash dump now by 
pressing the P key followed by RETURN. 


1.5 RUNNING CDA 


There are several ways to run CDA, and you can run it as either an 
installed or an uninstalled task. Also, you can run CDA from either 
the DCL or MCR command line interpreter (CLI). This section describes 
the alternative ways of running CDA. 


If CDA is an installed task on your system, you can enter the 
command line at the CLI prompt. After CDA processes your command, 
CLI prompt returns. In the following example, MCR is the CLI: 


CDA 

the 


>CDA CRASH_DUMP. LST ,COPY • CDA= [1,54] /STB, DR 5 : (RFf) 

> 


If CDA is installed and you want to enter commands directly to CDA, 
you can invoke the command level of the CDA utility by typing CDA and 
a carriage return. When you are finished using CDA, you exit from CDA 
by pressing CTRL/Z, which returns control to the CLI. In the 
following example, DCL is the CLI: 

$ CDA (RET) 

CDA>command line (ret) 

CDA>command line (ret) 

CDA>~Z 

$ 
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If CDA is an uninstalled task, the system has to find and install the 
CDA task image file before it can run CDA, Therefore, the command you 
use depends upon the location of the CDA task image file (CDA.TSK). 
If CDA.TSK is in the system UFD or the system library, type: 

RUN $CDA m 
CDA>command line (ret) 

CDA> 

On RSX-11M operating systems, you can use the RUN $CDA command only if 
CDA.TSK is present in the UFD that corresponds to the system UIC on 
device LB:. On RSX-11M-PLUS operating systems, CDA.TSK must be 
present in the UFD that corresponds to the library UIC. 

If CDA.TSK is present in the UFD that corresponds to the current UIC 
on the default system device (the current UFD for the terminal from 
which the command is entered), you can run CDA by typing the following 
command: 

RUN CDA (ED 
CDA>command line (ED 

Finally, you can run CDA by using the DCL ANALYZE/CRASH_DUMP command: 

$ ANALYZ E/CRASH_DUMP (RET) 

If your CLI is MCR, but your terminal also supports DCL, you can run 
the ANALYZE/CRASH_DUMP command by typing DCL and a space before the 
command. For example: 

>DCL ANALYZE/CRASH_DUMP ® 

Chapter 2 shows you how to use CDA command lines and the 
ANALYZE/CRASH DUMP command. 


1.6 INDIRECT COMMAND FILES 

As with other utilities, you can enter CDA command lines directly from 
the terminal or from an indirect command file. However, CDA indirect 
command files must not contain a reference to another command file. 


1.7 BASIC CRASH DUMP ANALYZER OUTPUT LISTING 

While the Crash Dump Analyzer provides many output listing options, 
fundamental system information appears on the first six pages of 
output listing (you can suppress this information by using the /-SYS 
switch, which is described in Chapter 2). The first six pages of 
output listings contain the following information: 

Page 1 — Volatile registers 

Page 2 — Kernel stack 

Page 3 — System common 

Page 4 — System common labeled dump 

Page 5 — Pool statistics 

Page 6 — Assign table 

Sections 3.1.1 through 3.1.6 describe these pages in detail. 
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The system information section also includes three more pages if the 
relevant information is in memory at the time of the crash. These 
pages display group-global event flags, error log packets, and, on 
RSX-llM-PLUS systems, the contents of low core memory. Section 3.1.7 
describes the group-global event flag page. Section 3.1.8 describes 
the error log page, and Section 3.1.9 describes the RSX-llM-PLUS low 
core memory page that is part of the system common dump. 
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CHAPTER 2 


COMMAND LINES 


CDA commands control how the Crash Dump Analyzer processes a memory 
dump and how it formats the output listings that it generates. You 
can use CDA command lines to enter commands directly to the CDA 
utility or, if your terminal supports the DIGITAL Command Language 
(DCL), you can use the DCL ANALYZE/CRASH_DUMP command to run CDA. 
This chapter describes CDA command lines and the ANALYZE/CRASH_DUMP 
command by showing the format of the command lines, the command 
specifications and qualifiers, and examples of how the commands work. 


2.1 CDA COMMAND LINES 

This section shows the CDA command line format, lists and describes 
command line switches, and provides some examples of CDA command 
lines. 

The CDA command line has the following format: 

CDA>[listfile/sw],[binaryfile/sw]=[symbolfi1e/STB],crash-input[/sw] 

The CDA command line specifies the input to CDA and the output from 
CDA. The specifications to the left of the equal sign in the command 
line are output specifications, and those on the right side of the 
equal sign are input specifications. 

You must include at least one output specification and one input 
specification in the command line. For output from CDA, you can 
specify a list file only, a binary file only, or both a list file and 
a binary file. For input to CDA, you must specify the crash-input, 
but the symbol file specification is optional. 

Output file specifications are position dependent. Position dependent 
means that when you include both output specifications, you must place 
them in the positions shown in the command line. If you omit the list 
file, you must place a comma before the binary file specification. 

Input file specifications are position independent and can appear in 
either order. 

The remainder of this section . describes CDA command line 

specifications. 

Output Specifications: 

listfile 

The output specification of the formatted CDA analysis listings. 
You can use either a device or a file as the list file 
specification. If you specify a file, CDA creates the file and 
writes the output listings to the file. By default, CDA then 
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spools the file to the system line printer queue, unless you 
specify otherwise. If you specify a device for the list file, 
CDA displays or prints its output listings on that specific 
device. For example, if you specify your terminal (TTnn: or 
TI:) as the list file, CDA displays the output listings on your 
terminal. Chapter 3 describes the analysis listings that CDA 
generates. 

binaryfile 

The file specification for the optional binary file. This file 
is a copy of the binary data that the crash dump routine wrote on 
the crash dump device. It allows you to selectively create an 
historical record of crash dumps. If you create this file during 
an initial analysis, you can use it for input to CDA at a later 
time. Since the crash dump routine overwrites the information on 
the crash dump volume with each successive dump, this feature 
allows you to use a single volume for all crash dumps. 

If the crash dump device on your system is a secondary storage or 
sequential device, you can reduce CDA analysis time by copying 
the crash input to a binary file on another device. Then you can 
use the binary file as input to CDA for analysis. 

Input Specifications: 

symbolfile/STB 

The file specification of the symbol table file for the crashed 
system. The /STB switch is an integral part of this file 
specification, because CDA uses the data in the symbol table file 
to format the binary memory dump into readable formats. If you 
omit this file specification and switch, CDA uses the default 
symbol table file, which is the file named RSX11M.STB in the UFD 
that corresponds to the current UIC. 

crash-input 

The source of the binary input to CDA. This specification can be 
either a device name (the crash dump device) or a binary file 
that was created during a previous CDA analysis. However, if the 
crash-input specification is a binary file, you cannot also 
include a binary file output specification in the command line. 

Switches: 

/sw 


An optional CDA switch. The list file, binary file, and 
crash-input file specifications can include optional switches 
that modify CDA action. Each specification in the command line 
has its own switches. Section 2.1.1 describes the CDA switches 
and lists which specification they apply to. 

File specifications in the CDA command line can appear in complete 
Files-11 format, with device name, UFD, file name, file type, and 
version number. When you omit any of these elements, CDA uses the 
defaults shown in Table 2-1. However, not all of the elements in file 
specifications have defaults. 
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Table 2-1 

File Default Values 





Default 

Value 

File 

Device 

UFD 

File Name 

File Type 

List file 

SY: 

Current 

None 

• LST 

Binary file 

SY: 

Current 

None 

.CDA 

Symbol file/STB 

SY: 

Current 

RSX11M 

.STB 

Crash-input 

SY: 

Current 

None 

.CDA 


See Section 2.1.2 for examples of CDA command lines, which include 
examples that show how CDA uses default file types. 


2.1.1 CDA Command Line Switches 

Two kinds of command line switches, analysis switches and function 
switches, allow you to control CDA operation. 

Analysis switches determine which analysis routines CDA applies to the 
crash input. Thus, you can select the types of data that you want CDA 
to output. For example, analysis switches can list information about 
all of the devices in the system, or they can list information about 
active devices only. 

Function switches provide a number of options for controlling CDA 
output. For example, function switches can terminate an analysis 
after CDA encounters a specified number of errors, or they can limit 
the number of pages of output listings. 

Both types of switches are file specific. That is, each switch 
applies to a particular file and may not be used without that file or 
with any other file. 


2.1.1.1 Analysis Switches - Table 2-2 summarizes the analysis 
switches and gives brief descriptions of their effects. Some of the 
switches in Table 2-2 have synonyms or alternate mnemonics. These are 
shown under each switch. Expanded descriptions of each switch follow 
the table. 


Table 2-2 

Summary of CDA Analysis Switches 


Applies to 

Switch Function File 


/ACT Lists the contents of the Task Crash-input 

/ATL Control Block (TCB) for each 

active task 

/ADV Lists information for all Crash-input 

devices in the system 

(Continued on next page) 
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Table 2-2 (Cont.) 

Summary of CDA Analysis Switches 


Applies to 

Switch Function File 


/ALL 


Lists the output of all 

analysis routines 

Crash-input 

/CL I 
/CPB 


Lists the contents of the CLI 
Parser Blocks in the system 

Crash-input 

/CLQ 


Lists the contents of the 

clock queue 

Crash-input 

/CTL 


Lists information for each 

device controller 

Crash-input 

/DEV 

/DCB 

/SCB 

/UCB 


Lists information for all 

active devices in the system 

Crash-input 

/DUMP:a:b 
/DMP:a:b: 

: [c] 

[c] 

Lists the contents of physical 
memory between address a and 
address b; (c is an optional 
virtual starting address) 

Crash-input 

/HDR 


Lists the contents of the task 
headers for each task resident 
in memory 

Crash-input 

/KDS:a:b 


Lists the contents of the 
kernel data space from virtual 
address a to virtual address b 
(RSX-11M-PLUS systems only) 

Crash-input 

/KIS:a:b 


Lists the contents of kernel 
instruction space from virtual 
address a to virtual address b 
(RSX-llM-PLUS systems only) 

Crash-input 

/PCB 

/PAR 


Lists the contents of each 
Partition Control Block 

Crash-input 

/POOL 


Lists the contents of the 

system's pool 

Crash-input 

/SECPOL 


Lists the contents of system 
secondary pool (RSX-llM-PLUS 
systems only) 

Crash-input 

/-SYS 


Suppresses listing of the 

system information 

Crash-input 

/TASK:name:a:b 
/TAS:name:a:b 
/TSKrname:a:b 

Lists the contents of task 
"name" between virtual address 
a and virtual address b; lists 
the contents of task data 
space (if task includes data 
space) on RSX-llM-PLUS 

Crash-input 


(Continued on next page) 
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Table 2-2 (Cont.) 

Summary of CDA Analysis Switches 


Switch 


Function 


Applies to 
File 


/TCB Lists the contents of the TCB Crash-input 

/TAL for every task in the System 

/STD Task Directory 

/TDS:name:a:b Lists the contents of task Crash-input 

data space (RSX-11M-PLUS only) 

/TIS:name:a:b Lists the contents of task Crash-input 

instruction space (RSX-11M-PLUS 
systems only) 


/ACT or /ATL (Task Control Blocks for Active Tasks) 
File: Crash-input 


Effect: CDA lists the contents of the Task Control Block (TCB) 

for each active task. 

/ADV (All Devices) 

File: Crash-input 

Effect: CDA lists the contents of the control blocks for all 
devices in the system. To list active devices, use the /DEV 
switch. 

/ALL (All Analysis Routines) 


File: Crash-input 


Effect: CDA applies all of its analysis routines 

associated with memory and task dumps) to 
crash-input. The output from these routines is 
following order: 


(except those 
the specified 
listed in the 


1. System information 


2. Active tasks information 


3. Task headers information 

4. Partition information 

5. Common Block Directory entries 

6. Device information 

7. Clock queue contents 

8. Device controller information 

9. Pool contents 
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/CLI or /CPB (Command Line Interpreter Parser Blocks) 

File: Crash-input 

Effect: CDA lists the contents of all Command Line Interpreter 

Parser Blocks (CPBs) in the system. 

/CLQ (Clock Queue) 

File: Crash-input 

Effect: CDA lists the contents of the clock queue. 

/CTL (Device Controllers) 

File: Crash-input 

Effect: CDA lists the contents of the controller table and 

Controller Request Block (KRB) for each device controller in the 
system. 

/DEV, /DCB, /SCB , or /UCB (Devices in System) 

File: Crash-input 

Effect: CDA scans the system device tables and lists the 

contents of the control blocks for each active device in the 
system. To list all devices, use the /ADV switch. 

/DUMP:a:b:[c] or /DMP (Physical Memory) 

File: Crash-input 

Effect: If only a and b are specified, CDA dumps the contents of 

physical addresses a through b inclusive and labels them with 

their physical addresses. If a, b, and c are specified, CDA 

dumps the contents of physical addresses a through b, but labels 
them with dummy virtual addresses, starting at the address 
specified by c. 

CDA allows you to specify a virtual starting address because 
RSX-11M and RSX-11M-PLUS systems use physical memory in terms of 
virtual addresses. If you dump physical memory labeled with the 
corresponding virtual addresses, you do not have to translate 
physical addresses to virtual addresses as you read the dump. 

/HDR (Headers for Memory-Resident Tasks) 

File: Crash-input 

Effect: CDA lists the contents of the task headers for each task 

resident in memory. 

/KDS:a:b (Kernel Data Space) 

File: Crash-input 

Effect: CDA lists the contents of kernel data space between the 

virtual addresses a and b inclusive. 

/KIS:a:b (Kernel Instruction Space) 

File: Crash-input 

Effect: CDA lists the contents of kernel instruction space 

between the virtual addresses a and b inclusive. 
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/PCB or /PAR (Partition Control Blocks) 

File: Crash-input 

Effect: CDA outputs a map that lists all the occupants of memory 

and the contents of each Partition Control Block (PCB). 

/POOL:a:b (System Pool) 

File: Crash-input 

Effect: CDA lists the system pool in octal, Radix-50, and ASCII. 

/SECPOOL[:a:b] (Secondary Pool) 

File: Crash-input 

Effect: Lists the contents of the secondary pool on RSX-11M-PLUS 

systems. 

/STD, /TCB, or /TAL (System Task Directory) 

File: Crash-input 

Effect: CDA lists the contents of all of the Task Control Blocks 

in the System Task Directory (STD) at the time of the crash. 

/-SYS (System Information) 

File: Crash-input 

Effect: CDA suppresses the system information listing. 

/TASK:name:a:b, /TAS, or /TSK (Task Virtual Address Space) 

File: Crash-input 

Effect: CDA lists the virtual address space from the 16-bit 

virtual address a through b for the task specified by "name." If 
you do not specify addresses, CDA lists the task's entire virtual 
address space. 

/TDS:name[:a:b] (Task Data Space) 

File: Crash-input 

Effect: CDA lists the contents of the task data space between 

the virtual addresses a and b inclusive. If you do not specify 

addresses, CDA lists the entire task data space. 

/TIS:name:a:b (Task Instruction Space) 

File: Crash-input 

Effect: CDA lists the contents of the task instruction space 

between the virtual addresses a and b inclusive. If you do not 

specify addresses, CDA lists the entire task instruction space. 


2.1.1.2 Function Switches 
switches and gives brief 
descriptions of each switch 


- Table 2-3 summarizes the 
descriptions of their effects, 
follow the table. 
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Table 2-3 

Summary of CDA Function Switches 


Switch 

Function 

Applies to 
File 

Default 1 

/BL:n 

Identifies the starting block 
number of the crash-input device; 
the value of n must be less 

than 65535. 

Crash- 

input 

n=l 

/DENS:n 

: HIGH 
:LOW 

Sets density of crash input tape 
to 800 or 1600 bits per inch 
(bpi) 

Crash- 

input 

n = 800 

/EXIT:n 

Terminates analysis after 

encountering n analysis errors 

List file 

— 

/LIMITtn 

Limits output listing to n pages 

List file 

n=300. 

/LINES:n 

Limits page length to n lines 

List file 

n=6 0. 

/MEMSIZ:n 

Saves nKb memory from crash in a 
binary file 

Binary 

file 

n=124. 

/KMR 

Forces the assignment of kernel 
address register values for the 
crashed system 

Crash- 

input 

/-KMR 

/-SP 

Does not print analysis output 
listing 

List file 

/SP 

/STB 

Identifies the file specifica¬ 
tion that contains the Executive 
symbol table 

Symbol file 

— 

1. n can be expressed as an octal or decimal 
point (.) following the number denotes decimal. 

number. A 

decima1 


/BL:n (Identify Starting Block Number) 

File: Crash-input 

Effect: CDA reads the dump from the input device beginning at 

block n. If the crash dump device is not a disk or a DECtape, 
CDA ignores this switch. 

Default: n = 1 

/DENS:n (Sets Tape Density) 

: HIGH 
:LOW 

File: Crash-input 

Effect: CDA reads the crash input tape at the density specified: 
800 or 1600 bpi. You can also use LOW to indicate 800 bpi or 
HIGH to indicate 1600 bpi. 

Default: n=800 
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/EXIT:n (Exit After n Errors) 

File: List file 

Effect: CDA maintains an error count. As it encounters 
inconsistencies in the system data structures, it increments this 
count. If you specify the /EXIT:n switch, CDA terminates 
analysis after n errors. If you specify the /EXIT switch but do 
not specify n f CDA exits after one error. 

Default: CDA runs to completion. 

/LIMIT:n (Limit Output Listing) 

File: List file 

Effect: The /LIMIT:n switch limits the number of pages of 
analysis output. When CDA has generated n pages, it terminates 
the analysis and prints a message on the user terminal indicating 
that it has done so. 

Default: n = 300. 

/LINES:n (Print n Lines per Page) 

File: List file 

Effect: This switch lets you specify the number of lines you 
want CDA to print per page. After n lines are printed, a new 
page is ejected. 

Default: n=60. 

/MEMSIZ:n (Establish Size of Binary Output File) 

File: Binary file 

Effect: This switch causes CDA to create a binary output file 

4*n blocks long and to transfer nKb words to it from the 
crash-input file. The value of n must be greater than 16. 

This switch is particularly useful when transferring binary crash 
dumps from disk or DECtape. Since disks and DECtapes have no 
physical EOFs, it is necessary to specify the size of the actual 
memory dump. 

When the crash input resides on magnetic tape, the binary output 
file is filled with zeroes if the EOF is read before nKb words 
are transferred. 

Default: n = 124. 

/KMR (Assign Kernel Mapping Register Values) 

File: Crash-input 

Effect: On mapped systems, when CDA reads incorrect Page Address 

Register (PAR) values from the crash stack, it aborts the 
analysis and prints an error message on the terminal. If this 
happens, you can use the /KMR switch to retry the analysis. When 
you specify /KMR, CDA uses standard mapping values to convert 
kernel virtual addresses to physical memory addresses. 

Default: CDA uses existing Page Address Registers. 
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/-SP (Do Not Spool) 

File: List file 

Effect: CDA does not spool the analysis output listing to the 

system line printer queue. Instead, it creates an output list 
file on the device indicated in the output file specification. 
If you do not specify a device in the output file specification 
when you use the /-SP qualifier, CDA creates the output list file 
on SYO:. 

Default: /SP 

/STB (File Specified Contains the Executive Symbol Table) 

File: Symbol file (RSX11M.STB) 

Effect: The /STB switch identifies a file containing the 

Executive symbol table. This file must correspond to the crashed 
system. CDA opens the symbol file and extracts the necessary 
symbol values. If it fails to find any required symbol values, 
CDA aborts the analysis and returns an error message. 

Default: [current UIC]RSX11M.STB 


2.1.2 CDA Command Line Examples 

The following examples illustrate CDA command lines. Assume that the 
user in these examples is logged in under UIC [301,356], that the 
crash dump device is DR5:, and that CDA is running as an installed 
task. Also, note how CDA uses default file types. 

Example 1 

>CDA (RET) 

CDA>DUMP , DUMP=RSX11M .STB/STB , DR5: (RET) 

This command line creates: 

• A list file, DUMP.LST, in UFD [301,356], which is printed 

automatically 

• A binary file, DUMP.CDA, in UFD [301,356] 

CDA reads the binary crash dump input from the crash dump device 

(DR5:), makes a binary copy of the crash dump input named DUMP.CDA, 
analyzes the crash dump input according to the information in the 
Executive symbol table file named RSX11M.STB in UFD [301,356], and 
writes a formatted output listing to a file named DUMP.LST. CDA then 
spools DUMP.LST to the system line printer queue. 

Example 2 

>CDA (RET) 

CDA> ,DUMP=[1,54]/STB,DR5: (H) 

This command line creates a binary file named DUMP.CDA in UFD 

[301,356]. 

CDA reads the binary crash dump input from DR5: and analyzes it 

according to the information in the Executive symbol table file, which 
is named RSX11M.STB in UFD [1,54]. 
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Example 3 

>CDA LP : = [ 1,54 ] /STB , DUMP (RET) 

> 

This command line creates an output listing on device LP:. 

CDA reads the binary input from a previously created binary file named 
DUMP.CDA, and analyzes it in accordance with the information contained 
in the Executive symbol table file named RSX11M.STB in UFD [1,54]. 
The CDA output listings are then printed on LP:. 

This command line is also an example of a CDA command that is issued 
from the CLI prompt. Thus, the CLI prompt returns after the command 
is issued. 

Example 4 

>CDA TI:=DUMP (SB 

> 

This command line creates an output listing that is displayed on the 
terminal from which the command was issued. 

CDA reads the binary input from a previously created binary file named 
DUMP.CDA and analyzes it according to the information in the default 
symbol table file, (the file named RSX11M.STB in the UFD that 
currently corresponds to UIC [301,356]). The CDA output listings are 
then displayed on TI:. 


2.2 THE DCL ANALYZE/CRASH_DOMP COMMAND 

If your terminal supports the DIGITAL Command Language (DCL) command 
line interpreter, you can run the CDA utility by using the DCL 
ANALYZE/CRASH_DUMP command as an alternative to the CDA command line. 
This section describes the ANALYZE/CRASH_DUMP command line format and 
qualifiers. The section concludes with some examples of 
ANALYZE/CRASH_DUMP command lines. 

The ANALYZE/CRASH_DUMP command line has the following format: 

ANALYZE/CRASH_DUMP [/qualifiers] crash-input[/qualifiers] 

You use the ANALYZE/CRASH_DUMP command to specify CDA input and 
output. The command qualifiers that you place immediately after the 
command name specify the CDA output files and, optionally, the symbol 
table file that CDA uses to process the crash dump input. The 
crash-input specification is mandatory because it directs CDA to the 
source of the binary crash dump input. 

Output Specifications: 

You must specify at least one of the following command qualifiers as 
an output specification in the command line: 

• /LIST: Specifies the output list file 

• /BINARY: Specifies a binary copy of the crash-input file 

• /SYMBOLS: Specifies the symbol definition file 
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You can specify /LIST: only, /BINARY: only, or /LIST: and /BINARY: 
together. You can optionally specify /SYMBOLS: with any combination 
of the /LIST: and /BINARY: qualifiers. However, if you do specify 
/SYMBOLS, you must include at least one of the other command 
qualifiers (because the symbol definition file is not an output file; 
it is used by CDA to generate an output file). Section 2.2.1.1. 
provides complete descriptions of the functions of each of the command 
qualifiers. 

If you omit the crash-input specification from the command line, CDA 
prompts you for it, as shown in the following example: 

$ ANALYZE/CRASH_DUMP/LIST : LP : (ret) 

Crash input? DR5: © 

If you enter the command name only, CDA prompts you for input and 
output, as shown in the following example: 

$ ANALYZE/CRASH_DUMP (RET) 

Crash output? /LIST:SY:[301,356]CRASH.LST:/BINARY:COPY.CDA ® 
Crash input? DUMP.CDA (ret) 

Note that if you enter an output file in this way, you must include 
the /LIST: or /BINARY: qualifiers as part of the output file 

specification. 

Input Specification: 

crash-input 

Specifies the location of the binary input to the 
ANALYZE/CRASH_DUMP command. The crash-input specification can be 
the name of the crash dump device, or it can be a binary file 
that was created during a previous crash dump analysis. 

When you enter an ANALYZE/CRASH_DUMP command line, you can include 
command qualifiers, qualifiers for the crash-input parameter, or both. 
Section 2.2.1 describes qualifiers. 


2.2.1 ANALYZE/CRASH_DUMP Command Qualifiers 

You can control the way CDA processes the crash input and how it 
formats the output listings by using command qualifiers in the command 
line. You can select the information that you want in the CDA output 
listings by using qualifiers for the crash-input specification. 
Section 2.2.1.1 describes command qualifiers. Section 2.2.1.2 
describes the qualifiers that you can use when you specify the crash 
input. 


2.2.1.1 Command Qualifiers - You can use command qualifiers with the 
ANALYZE/CRASH_DUMP command to control how CDA processes the binary 
crash-input, and how it formats the output analysis listings. You 
place command qualifiers immediately after the command name in the 
command line. Table 2-4 summarizes the command qualifiers and gives 
brief descriptions of their effects. Expanded descriptions of each 
qualifier follow the table. 
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Table 2-4 

Summary of ANALYZE/CRASH_DUMP Command Qualifiers 


Command Qualifier 

Function 

Applies to 

File 

/LIST:listfile[/qualifiers] 

Specifies the output 
list file or device 

List file 

listfile qualifiers: 

/ERROR_LIMIT 

Specifies an error 
limit at which CDA 
analysis terminates 

List file 

/PAGE_COUNT:n 

Specifies the number 
of output pages 

List file 

/PAGE_LENGTH:n 

Specifies the number 
of output lines per 
page 

List file 

/[NO]PRINTER 

Specifies whether 
the output should be 
printed on the 
system line printer 

List file 

/BINARY:binaryfile[/qual] 

Specifies an optional 
copy of the binary 
input file 

Crash-input 

binaryfile qualifier: 

/MEMORY_SIZE:n 

Copies nKb words of 
memory from a crashed 
system 

Crash-input 

/SYMBOLS:symbolfile 

Specifies the symbol 
definition file 

Crash-input 


Command Qualifier Descriptions: 

/LIST:listfile[/qualifiers] 

/ERROR_LIMIT[:n] 

/PAGE_COUNT:n 
/PAGE_LENGTH:n 
/[NO]PRINTER 

File: List file 

Effect: Specifies the optional formatted CDA output list 

file. This list file consists of the analysis report listings 
that are described in Chapter 3. You can also specify a device 
for the list file, in which case CDA displays or prints its 
output listings on the specified device. You can control the 
list file output by using the following file qualifiers. 
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List File Qualifiers: 

/ERROR_LIMIT[:n] 

Effect: CDA maintains an error count. As it encounters 

inconsistencies in the system data structures, it 
increments the error count. CDA terminates the crash dump 
analysis when it finds the number of errors that you 
specify with this qualifier. If you use the /ERROR_LIMIT 
qualifier without specifying a number, the crash dump 
analysis terminates after one error. 

Default: CDA runs the analysis until it is completed. 

/PAGE__COUNT: n 

Effect: This qualifier limits the number of pages of 

analysis output. When CDA has generated n pages, it 
terminates the analysis and prints a message on the 
terminal indicating that the analysis has terminated. 

Default: Analysis terminates after 300 pages. 

/PAGE__LENGTH : n 

Effect: This qualifier lets you specify the number of 

lines that you want CDA to print per output page. After 
the specified number of lines are printed, CDA breaks to a 
new page. 

Default: CDA prints 60 lines per page. 

/[NO]PRINTER 

Effect: This qualifier prevents the printing of the 
analysis output on the system line printer. Instead, CDA 
creates the output list file on the device in the list 
file specification. If a device is not specified in the 
list file specification, CDA creates the output file on 
the default user disk (SYO:). 

Default: CDA prints all output on the system line 

printer. 

/BINARY:binaryfile[/qualifier] 

/MEMORY_SIZ E:n 

File: Crash-input 

Effect: Specifies that an optional binary file should be 

created. This file is a copy of the binary data that the crash 
dump routine wrote on the crash dump device. If you create the 
file during an initial analysis, you can use it as input to the 
ANALYZE/CRASH_DUMP command at a later time. Also, because the 
crash dump routine overwrites the contents of the crash dump 
volume with each crash dump, this qualifier allows you to save 
the results of crash dumps. You can then reuse the same volume 
for successive crash dumps while maintaining a record of 
previous crash dumps. 
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Binary File Qualifier: 

/MEMORY_SIZE:n 

Effect: Specifies memory size for the binary copy of the 

crash dump input file. You specify n, where n is the 
number of Kb words. CDA then creates a binary file 4n 
words long and transfers nKb words to it from the 
crash-input file. The value of n must be greater than 
16(decimal). 

Default: n=124 

/SYMBOLS:symbolfile 

File: Symbol definition file 

Effect: Specifies the symbol definition file for the crashed 

system, which contains the Executive symbol table. The symbol 
file must correspond to the crashed system. CDA opens the file 
and extracts the necessary symbol values. If it fails to find 
any required symbol values, CDA aborts the analysis and returns 
an error message. If you omit this file specification, CDA 
uses the default file, which is the file named RSX11M.STB in 
the UFD that corresponds to the current UIC. 


2.2.1.2 Crash-input File Qualifiers - You can select the analysis 
listings that you want CDA to output by using qualifiers for the 
crash-input file specification in the ANALYZE/CRASH_DUMP command 
line. Table 2-5 summarizes the crash-input qualifiers and gives 
brief descriptions of their effects. Expanded descriptions of each 
qualifier follow the table. 


Table 2-5 

Summary of ANALYZE/CRASH_DUMP Crash-input Qualifiers 


Qualifier or Argument 


Function 


Applies 

File 


to 


/ACTIVE:(arg[,...]) 

Lists data on active 
tasks and/or devices 

Crash-input 

/ACTIVE arguments: 



DEVICES 

Lists data about 
active devices 

Crash-input 

TASKS 

Lists contents of the 
Task Control Blocks 
for active tasks 

Crash-input 

/ALL 

Lists all available 
crash dump data 

Crash-input 

/BLOCK:n 

Specifies the block 
number where crash 
dump begins on the 
crash dump device 

Crash-input 


(Continued on next page) 
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Table 2-5 (Cont.) 

Summary of ANALYZE/CRASH_DUMP Crash-input Qualifiers 


Qualifier or Argument 


Applies to 

Function File 


/CLOCK_QUEUE 

/CONTROLLERS 

/DATA_STRUCTURES:(arg[,...]) 

/DATA_STRUCTURES arguments: 
COMMAND_PARSER 

DEVICE 

STATUS 

UNIT 

PARTITION 


TASK 


Lists the contents of Crash-input 
the clock queue 

Lists device Crash-input 

controller data 

Specifies which data Crash-input 
structures are to be 
formatted and listed 


Lists contents of Crash-input 

CLI Parser Blocks 

List contents of the Crash-input 
control blocks for 
active devices 


Lists contents of Crash-input 

Partition Control 

Blocks 

Lists contents of the Crash-input 
Task Control Blocks 
for tasks in the STD 


/DENSITYin 


Specifies bits per Crash-input 

inch for input device 


/DEVICES 


Lists contents of all Crash-input 
Device Control Blocks 


/DUMP[: (START:n , END:n ,ADDRESS:n)] Lists contents of 

physical addresses 


Crash-input 


/HEADERS 


Lists contents of Crash-input 

resident task headers 


/KERNEL:(arg[,... ] ) 


Lists kernel contents Crash-input 


/KERNEL arguments: 

DATA:(START:n , END:n) 

INSTRUCTION:(START:n,END:n) 

REGISTERS 


Lists contents of Crash-input 

kernel data space 

Lists contents of Crash-input 

kernel instruction 

space 

Forces assignment of Crash-input 
values for the kernel 
address registers 


(Continued on next page) 
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Table 2-5 (Cont.) 

Summary of ANALYZE/CRASH_DUMP Crash-input Qualifiers 


Applies to 

Qualifier or Argument Function File 


/PARTITION 

Lists contents of 
Partition Control 
Blocks 

Crash-input 

/POOL:(START:n,END:n) 

Lists pool contents 

Crash-input 

/SECONDARY_POOL[:(START:n,END:n)] 

Lists contents of 
secondary pool from 
START to END 

Crash-input 

/[NO]SYSTEM 

Suppresses listing of 
system information 

Crash-input 

/TASKS:(arg [,...]) 

Lists task data 

Crash-input 

/TASKS arguments: 



DIRECTORY 

Lists contents of the 
Task Control Blocks 
for tasks in the STD 

Crash-input 

ADDRESS:(NAME:name[,START:n,END: n]) 

Lists contents of 
task addresses from 
START to END 

Crash-input 

DATA:(NAME:name[,START:n,END:n]) 

Lists contents of 
task data space 

Crash-input 

INSTRUCTION:(NAME:[,START:n,END:n]) 

Lists contents of 

Crash-input 


task instruction space 


File Qualifier Descriptions: 

/ACTIVE:(arg[,...]) 

DEVICES 

TASKS 

File: Crash-input 

Effect: Lists data on active tasks and devices, 

/ACTIVE arguments: 

DEVICES 

Effect: Lists data on the devices active in the system at 

the time of the crash. If you want CDA to list data on all 
of the devices known to the system at the time of the crash, 
use the /DEVICES qualifier. 


TASKS 


Effect: Lists the contents of the Task Control Blocks of 
active tasks. If you want CDA to list the contents of the 
Task Control Blocks of all installed tasks, both active and 
dormant, use the /TASKS: (DIRECTORY) qualifier. 
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/ALL 

File: Crash-input 

Effect: Analyzes all information available in the crash dump 

file (except the information associated with memory and task 
dumps). CDA lists the output in the following order: 

1. System information 

2. Active tasks information 

3. Task headers information 

4. Partition information 

5. Common Block Directory entries 

6. Device information 

7. Clock queue contents 

8. Device controller information 

9. Pool contents 
/BLOCK:n 

File: Crash-input 

Effect: Identifies the starting block number of the crash dump 
file on the crash input device. The value of n must be less than 
65535(decimal). 

/CLOCK_QUEUE 

File: Crash-input 

Effect: Lists the contents of the system clock queue. 

/CONTROLLERS 

File: Crash-input 

Effect: Lists the contents of the controller table and 

Controller Request Block (KRB) for each device controller in the 
system. 

/DATA_STRUCTURES: (arg [ r ...]) 

COMMANDPARSER 

DEVICE 

PARTITION 

STATUS 

TASK 

UNIT 

File: Crash-input 

Effect: Selects which system data structures CDA will format and 

list. 
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/DATA_STRUCTURES arguments: 
COMMAND PARSER 


Effect: Lists the contents of the Command Line Interpreter 

(CLI) Parser Blocks. 


PARTITION 

Effect: Lists the contents of the Partition Control Blocks. 

TASK 

Effect: Lists the contents of the Task Control Block for 

every task in the System Task Directory (all installed 
tasks) at the time of the system crash. 

DEVICE 


Effect: Lists the contents of the Device Control Blocks for 

active devices. 


STATUS 


Effect: Lists the contents of the Status Control Blocks for 

active devices. 


UNIT 


Effect: Lists the contents of the Unit Control Blocks for 

active devices. 


/DENSITY:n 

File: Crash-input 

Effect: Causes a crash input tape to be read at the density 

specified, 800 or 1600 bpi. The default is 800 bpi. 

/DEVICES 

File: Crash-input 

Effect: Lists the contents of the control blocks for all devices 

in the system. To list only active devices, use the 
/ACTIVE:(DEVICES) qualifier. 

/DUMP[:(START:a,END:b[,ADDRESS:c])] 

File: Crash-input 

Effect: Lists the contents of physical addresses a through b 
inclusive and labels them with their physical addresses. If you 
include address c, the /DUMP qualifier dumps the contents of 
physical addresses a through b, but labels them with dummy 
virtual addresses, starting at c. 

/HEADERS 

File: Crash-input 

Effect: Lists the contents of the task headers for each task 
resident in memory. 
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/KERNEL:(arg [,...]) 

DATA:(START:n,END:n) 

INSTRUCTION: (START:n,END:n) 

REGISTERS 

File: Crash-input 

Effect: Lists kernel data. 

/KERNEL arguments: 

DATA:(START:n,END:n) 

Effect: Lists the contents of kernel data space from 

virtual addresses START:n to END:n. 

INSTRUCTION:(START:n,END:n) 

Effect: Lists the contents of kernel instruction space from 

virtual address START:n to END:n. 

REGISTERS 

Effect: Forces the assignment of the kernel address 

register values for the crashed system. 

/PARTITION 

File: Crash-input 

Effect: Lists the contents of the Partition Control Blocks. 

/POOL:(START: n, END:n) 

File: Crash-input 

Effect: Lists the contents of system pool between the addresses 

specified in octal, Radix-50, and ASCII. 

/SECONDARY_POOL:(START:n,END:n)] 

File: Crash-input 

Effect: Lists the contents of system secondary pool between the 

addresses specified by START and END. 

/[NO]SYSTEM 

File: Crash-input 

Effect: The /NOSYSTEM qualifier suppresses the system 

information listing. The default action of CDA is /SYSTEM; that 
is, it lists the system information. 

/TASKS:(arg[,...]) 

DIRECTORY 

ADDRESS:(NAME:name,START:n,END:n) 

DATA:(NAME:name[,START:n,END:n]) 

INSTRUCTION:(NAME:name[,START:n,END:n]) 

File: Crash-inpu^ 

Effect: Lists task data. 
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/TASKS arguments: 

DIRECTORY 

Effect: Lists the contents of the Task Control Block for 

every task in the System Task Directory (all installed 
tasks) at the time of the system crash. 

ADDRESS: (NAME:name,START:n , END:n) 

Effect: Lists the contents of the task specified by NAME 

between the virtual addresses specified by START and END. 

Includes the contents of task data space if a task includes 

data space. 

DATA:(NAME:name[,START:n,END:n]) 

Effect: RSX-11M-PLUS operating systems only. Lists the 

contents of task data space for the task specified by NAME. 

INSTRUCTION:(NAME:name[ r START: n ,END:n]) 

Effect: RSX-11M-PLUS operating systems only. Lists the 

contents of task instruction space for the task specified by 
NAME. 


2.2.2 ANALYZE/CRASH_DUMP Command Examples 

The following examples illustrate the ANALYZE/CRASH_DUMP command. 
Assume that the user in these examples is logged in under UIC 
[301,356], and that the crash dump device is DR5:• In this way, you 
can note how CDA uses default file types. Also, assume that CDA is 
running as an installed task. 

Example 1 

$ ANALYZE/CRASH_DUMP/LIST:CRASH/BINARY:COPY/MEMORYSIZE:250 DR5: © 
This command creates: 

• An output list file named CRASH.LST in the current UFD for UIC 
[301,356]. 

• A binary copy of 250kb words of the crash dump from DR5: (the 

crash dump device). The copy is named COPY.CDA and is placed 
in the current UFD for UIC [301,56]. 

CDA reads the binary crash dump input from the crash dump device and 
analyzes it according to the default symbol definition file, since a 
symbol definition file is not specified in the command line. CDA uses 
the file named RSX11M.STB in the current UIC as the symbol definition 
file. CDA then generates a list file named CRASH.LST and spools it to 
the default system line printer queue. CDA also copies the specified 
amount of memory from the crash dump device to a binary file named 
COPY.CDA. 

Example 2 

$ ANALYZE/CRASH_DUMP/LIST:LP5:/PAGE_COUNT:5 DR5:/BL:100 ® 

This command creates a list file that is printed on LP5:. 

CDA reads the crash input from DR5:, beginning at block 100, and 
analyzes it according to the default symbol definition file. CDA then 
prints the first five pages of its output listing on LP5:• 
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3.1.3 System Common 

The listing in Figure 3-3 provides a selective interpretation of some 
of the items in system common. Each item in the following describes 
the corresponding numbered item in Figure 3-3. (Refer to the RSX-11M 
Guide to Writing an I/O D river or the RSX-11M-PLUS Guide to Writing an 
I/O Driver for further information.) 

Item Description 

1. Time and date of crash, as set in the system 

2. The task that was running at the time of the crash (If no 
task was running, this field contains the null task. 
This condition could develop if all the active tasks are 
blocked at the time of the crash. For information on 
determining which task or driver was mapped at the time 
of the crash, see Section 4.1.1.) 

3. The address of the Task Control Block (TCB) of the 
current task 

4. The contents of the 4-byte system ID indicating system 
base level 

5. The first address available for partitions (the last 
address of the Executive plus 1) 

6. The system size in 32-word blocks and in total words 

7. System UIC 

8. Stack depth count 

9. Contents of the global event flag words 

10. Name of the system for which dump is generated 

11. Network UIC 

12. Device from which the system was booted 

13. Logical block number (LBN) of the beginning of the system 
image 

14. Size of system image file in blocks 

15. The octal value of the system feature masks and the 
meaning of each set bit 

16. Octal dump of system common in offset mode in numerical 
order by address 



9 

# 

9 
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R8X-11M CRASH DUMP ANALYZER V4.2 19-APR-85 15U3 

SYSTEM COMMON 


CRASH OCCURRED AT 09l53lSl 21-MAY-6l(T) 

© © 

CURRENT TASK a LOR... TCB ADDRESS a 1 12050^ 

© © © (J 

SSYSID a: S0E IEXSIZ s 1 15000 SSYSIZ a 1638a,/512K SSYUIC i 

(© (®) 

SSTKOP a 000000 SCOMEFl <33-48> 000000 <49-64> 000000 

® © 

SYSTEM NAME = QUASAR SNTUIC a [102,54] 

@ ® ® 

LOAD DEVICE = DB0 LBN a 00i2a461 FILE SIZE a 496, 

SYSTEM FEATURE MASK (FIRST WORD) a 033377 ^ 


BIT SET 

MEANING 

EXT 

22-BIT EXTENDED MEMORY SUPPORT 

HUP 

MULTI-USER PROTECTION SUPPORT 

EX V 

20K EXEC SUPPORTED 

DRV 

loadable driver support 

P LA 

PLAS SUPPORT 

CAL 

DYNAMIC CHECKPOINT SPACE ALLOCATION 

PKT 

PREALLOCATION OF I/O PACKETS 

EXP 

extend task directive supported 

OFF 

PARENT/OFFSPRING TASKING SUPPORTED 

FDT 

FULL OUPLEX TERMINAL DRIVER 

DYM 

DYNAMIC MEMORY ALLOCATION SUPPORTED 

CEX 

COMMUNICATIONS EXEC IS LOADED 


SYSTEM FEATURE MASK (SECOND WORD) ■ 167400 


BIT SET 


MEANING 




DPR DIRECTIVE PARTITION SUPPORT 

IRR INSTALL# REQUEST, AND REMOVE TASK SUPPORT 

GGF GROUP GLOBAL EVENT FLAG SUPPORT 

RAS RECEIVE/SEND DATA PACKET SUPPORT 

RBN ROUND ROBIN SCHEDULING SUPPORTED 

SWP EXECUTIVE LEVEL DISK SWAPPING SUPPORTED 

STP EVENT FLAG MASK IS IN THE TCB 


SYSTEM FEATURE MASK (THIRD WORD) a 025215 
BIT SET MEANING 


CLI MULTIPLE CLI SUPPORT 

EIS SYSTEM REQUIRES THE EXTENDED INSTRUCTION SET 

CRA SYSTEM SPONTANEOUSLY CRASHED (liYES) 

STM SYSTEM HAS SET SYSTEM TIME DIRECTIVE 

AST SYSTEM HAS AST SUPPORT 

J 


Figure 3-3 System Common 
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$CRLCK 

One CPU dumps memory 

$CRSUN 

Crash physical unit number 

$CTLST 

Start of the Controller Table (CTB) list 

$CURPR 

Current task priority 

$CXDBL 

Context switching disabled flag 

$DEVHD 

Pointer to first Device Control Block (DCB) 

$DICSV 

Temporary storage for directive services 

$DRAPR 

APR value to map directive partition 

$DVSAV 

Saved CSR contents for error logging 

$ENTSQ 

Error log entry sequence number 

$ERFLA 

Error Logger flag word 

$ERHEA 

Error Log message queue listhead 

$ERRPT 

Pointer to Error Logger Task Control Block 

$ERRSQ 

Universal error sequence number 

$EVBSQ 

Buffer sequence number 

$EVDIS 

Buffer position for next event 

$EVKS6 

KISAR6 offset to buffer 

$EVLEN 

Pointer to word beyond end of buffer 

$EVLOS 

Number of events lost through saturation 

$EVSEQ 

Event sequence number 

$EVTCB 

TCB address of event logger task 

$EXCRC 

Executive read-only code cyclic redundancy check (CRC) 

$EXECL 

Serialize access to executive data lock 

$EXSIZ 

Executive size 

$FMASK 

System feature mask 

$FORKL 

Serialize access to fork list lock 

$FRKHD 

Fork queue listhead 

$FXRPT 

Pointer to parity error task 

$GEFDM 

Group-global dummy mask address word 

$GEFPT 

Group-global mask address pointer 

$GFTCB 

Group-global user TCB pointer 

$GGEF 

Group-global event flags listhead 

$GNLST 

General use pool packet listhead 
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$HEADR 

$HFMSK 

$HRCPT 

$ICAVL 

$IDLCT 

$IDLFL 

$IDLPT 

$IICPU 

$1IFNL 

$1IMSK 

$1INXT 

$11 PND 

$INTCT 

$LBUIC 

$LDPCB 

$LDRPT 

$LOGHD 

$LSTLK 

$MCRPT 

$MOULS 

$MXEXT 

$NCPU 

$NTUIC 

$PARHD 

$PASTH 

$PFRSZ 

$PFURM 

$PKAVL 

$PKMAX 

$PKNUM 

$PLPAR 

$POLBP 


Pointer to current task header 
Hardware system feature mask 

Pointer to HRC... task (privileged task for 

reconfiguration services) 

ICB pool; same as core pool if no data space on system 

Idle pattern count byte 

Idle pattern flag in bytes 

Idle pattern word 

Mask of interrupted URMs 

Serialize access to $MPTAB lock 

list interrupt mask word 

Round robin word for $IISVC 

Pending URM work word 

Clock interrupt ticks count 

Library UIC 

Current loader PCB pointer 
Pointer to loader TCB 
Logical device assignment listhead 
Lock word; TCB address of owner 
Pointer to MCR TCB 
Mount listhead 

Last address in system common 
Number of processors in system 
Network UIC 

Pointer to partition list 
Partition AST listhead 

Minimum size of largest fragment in pool 
URM to powerfail 

Pointer to first preallocated I/O packet 
Maximum number of preallocated I/O packets 
Number of preallocated I/O packets currently in list 
Pointer to secondary pool PCB 

Minimum priority for nonprivileged task to execute at 
low pool 
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$POLFL 

Executive pool usage control flags 

$POLHD 

Listhead for secondary pool free list 

$POLST 

Executive pool communications word 

$PRIFR 

Current amount of free pool 

$PRIHL 

Upper limit for pool monitoring 

$PRILL 

Lower limit for pool monitoring 

$PRISZ 

Minimum size of largest pool fragment 

$PRMOD 

Processor model number 

$PRTAB 

Processor current task priority table 

$PTCBL 

Prototype TCB listhead 

$PTCPT 

KISAR6 bias of prototype TCB 

$PTTCB 

TCB address of pool recovery task 

$PWRFL 

Power-fail recovery request flag 

$PWRLK 

Serialize access to $PWRMK lock 

$PWRMK 

Mask of CPU in power-fail code 

$RNDC 

Clock ticks for each scheduling interval 

$RNDCT 

Number of clock ticks until next scheduled interval 

$RNDH 

Highest priority class to consider 

$RNDL 

Lowest priority class to consider 

$ROEND 

End of read-only part of the Executive 

$RQSCH 

Schedule request TCB address 

$RQTAB 

Reschedule pointer to TCB table 

$SABPT 

Pointer to System Account Block 

$SAHDB 

Bias of current task header 

$SAHPT 

Virtual address of current task header 

$SAVSP 

Saved stack pointer 

$SCCTB 

CTB if $SCDEV contains KRB 

$SCDEV 

UCB or KRB for status change 

$SCERR 

Error return from driver 

$SCMOF 

Offset to data space 

$SCOFL 

On-line or off-line parameter 

$SECFR 

Number of free blocks in secondary pool 

$SGFFR 

Pointer into stack for $SGFIN 
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$SHERR Points to TCB of shadow error task 
$SHFCT Minimum ticks between shuffler requests 
$SHFPT Pointer to Shuffler Task Control Block 

$SHFTM Time remaining before next possible request to Shuffler 
$SHLIM Error packet limit 

$SHLOS Number of packets lost from saturation 
$SHPCT Current shadow error count 

$SHtJMB Root for UMB list 

$SIGFL Task waiting for significant event 

$STALR Sanity timer alarm enabled on CPU 

$STENB Sanity timer enabled 

$STKDP Stack depth indicator 

$SWPC Clock ticks for each swapping interval 

$SWPCT Number of clock ticks to next swapping interval 

$SWPR Swapping priority 

$SWR Multiprocessor console switch register 

$SYLHD Listhead for System log input queue 
$SYSIZ Size of memory in 32Kb-word blocks 
$SYUAB Address of UAB for system tasks 
$SYUIC System User Identification Code (UIC) 

$TKNPT Pointer to Task Termination Notification Program (TKTN) 
Task Control Block 

$TKPS Ticks per second 

$TNAME Multiuser task name 

$TSKHD Pointer to System Task Directory (STD) 

$TTNS Tick of second 

$ULDPT Microcode loader task TCB address 

$UMRST Unibus Run Mask (URM) status table 

$VECTR Highest vector address 

$XDTFL Executive Debugging Tool (XDT) initialization table 
$XDTPR Flag for prompts from XDT 
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RSX-11M CRASH 
SYSTEM COMMON 

DUMP ANALYZER 
ALPHABETIZED 

V4.2 

DUMP 

1APR 

-85 15113 

PAGE 6 

SABTIM 

007572 

SERRPT 

000000 

SNETPF 

000000 

SSwPCT 

000036 

sacthd 

112050 

SERRSQ 

000000 

SNTUIC 

041054 

SSYSIZ 

040000 

SAVRHD 

000000 

SEXSIZ 

115000 

SPARHD 

11473a 

SSYSNM 

052521 

scflpt 

046444 

SFMASK 

033377 

SPARPT 

017226 

SSYUIC 

001054 

SCKCNT 

177546 

sfrkhd 

000000 

SPFRSZ 

000310 

STEMP0 

110160 

SCKCSR 

177546 

SGEFDM 

000356 

SPKAVL 

072230 

STEMP1 

064170 

SCKLOC 

000000 

SGEFPT 

010064 

SPKMAX 

017 

STEMP2 

013356 

SCLICQ 

000000 

SGFTCB 

010064 

SPKNUM 

012 

STEMP4 

000000 

SCLKHO 

044414 

SGGEF 

000000 

SPOLBP 

000063 

STKNPT 

107134 

SCOPT 

037356 

SHEADR 

111700 

SPOLFL 

000200 

STKPS 

000074 

SCPTBL 

010472 

SHFMSK 

000003 

SPOLL* 

000144 

STKTCB 

112050 

SCRAVL 

045074 

SIOLCT 

000 

SPOLST 

000403 

STSKHD 

112050 

SCURPR 

370 

SIDLFL 

000 

SPRIHL 

003100 

STTNS 

000066 

SCXDBL 

000 

SIDLPT 

103741 

SPRILL 

001130 

SUMRHD 

052642 

SDEVHD 

063460 

SINTCT 

177777 

SPRISZ 

003370 

SUMRPT 

170200 

SDICSV 

001051 

SLBUIC 

000454 

SPR MOD 

000000 

SUHRnT 

000000 

SDPM 

000040 

SLDRPT 

112050 

SPTTCB 

053510 

SWTCSR 

017226 

SENTSQ 

000001 

SLOGHD 

052254 

SPwRFL 

000000 

SWTDUM 

017226 

SERBAF 

023 

slstlk 

103640 

SRNDCT 

000005 

SXC0M1 

001600 

SERF ID 

000000 

SMCRCB 

104360 

SRQSCH 

000000 

SXC0M2 

001746 

SERFLA 

000 

SMCRPT 

110160 

SSHFPT 

106704 



SERHEA 

000000 

SMQULS 

046614 

SSIGFL 

000000 



SERLOF 

000 

smxext 

177777 

SSTKDP 

000000 




Figure 3-4 System Common Alphabetized Dump 
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3.1.5 Pool Statistics 


The listing in Figure 3-5 contains information concerning the system 
pool. CDA derives Items 2, 3 , and 4 by scanning the free block 
pointers of the pool. The minimum block size (that is, pool 
granularity) in Item 5 comes from the contents of $CRAVL-2. Each item 
in the following list describes a correspondingly numbered item in 
Figure 3-5. 


I tern 
1. 
2 . 

3. 

4. 

5. 

6 . 


Description 

Pool size in decimal bytes 
The largest fragment of pool space 
Total number of free bytes in ,pool 
Number of fragments not allocated 

Smallest possible block (This is the minimum number of 


bytes which may be requested at a time, 
block size is always four bytes.) 

Bit map in octal 


The minimum 


Each bit in the bit map represents one 4-byte block. If the bit is 
set, the block is free. The first block in the pool is bit 0 of the 
first octal word in the bit map. The bits are numbered as 


Bit Number 

Binary 

Octal 


15 

0 

0 


14 13 12 
Oil 
3 


11 10 9 
10 1 
5 


8 7 6 
111 
7 


1 1 
7 


Any bits left over in the last word of the bit map are cleared. 


follows: 

4 3 2 1 0 


0 0 0 
0 
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R8X-11M CRASH DUMP ANALYZER V4.2 19-APR-05 10«56 

POOL statistics 

POOL SIZE (BYTES) a 16532. © 

LARGEST FREE BLOCK (BYTES) s 12«l6.© 

TOTAL FREE BYTES s 12676.® 

NUMBER OF FRAGMENTS * 10.® 

MINIMUM BLOCK SIZE (BYTES) = 4.® 


PAGE 5 



POOL BITMAP (CONSTRUCTED FROM LINKED POOL, BLOCK FREE IF BIT SET)I 


000000 100434 
000000 000000 
176000 177777 
177777 177777 
177777 177777 
177777 177777 
177777 177777 
177777 177777 
177777 177777 
177777 177777 
177777 177777 
177777 177777 
177777 177777 
177777 177777 
177777 177777 
177777 177777 
177777 177777 
177777 177777 
177777 177777 
177777 177777 
177777 177777 
177777 177777 
177777 177777 
177777 177777 
177777 177777 
177777 177777 
177777 177777 
000037 000000 
000000 000000 
000000 000000 
000000 000000 
000000 000000 
000000 000000 


000000 007000 
000000 000000 
177777 017777 
177777 177777 
177777 177777 
177777 177777 
177777 177777 
177777 177777 
177777 177777 
177777 177777 
177777 177777 
177777 177777 
177777 177777 
177777 177777 
177777 177777 
177777 177777 
177777 177777 
177777 177777 
177777 177777 
177777 177777 
177777 177777 
177777 177777 
177777 177777 
177777 177777 
177777 177777 
177777 177777 
177777 177777 
000000 000000 
000000 000000 
000000 000000 
000000 000000 
000000 000000 
000000 


000040 140000 
000004 000000 
000000 000000 
177777 177777 
177777 177777 
177777 177777 
177777 177777 
177777 177777 
177777 177777 
177777 177777 
177777 177777 
177777 177777 
177777 177777 
177777 177777 
177777 177777 
177777 177777 
177777 177777 
177777 177777 
177777 177777 
177777 177777 
177777 177777 
177777 177777 
177777 177777 
177777 177777 
177777 177777 
177777 177777 
177777 177777 
000000 000000 
000000 000000 
000000 000000 
000000 000000 
000000 000000 


002001 000000 
000000 000000 
177740 177777 

177777 177777 

177777 177777 

177777 177777 

177777 177777 

177777 177777 

177777 *177777 

177777 177777 

177777 177777 

177777 177777 

177777 177777 

177777 177777 

177777 177777 

177777 177777 

177777 177777 

177777 177777 

177777 177777 

177777 177777 

177777 177777 

177777 177777 

177777 177777 

177777 177777 

177777 177777 

177777 177777 

177777 177777 

000000 000000 
000000 000000 
000000 000000 
000000 000000 
000000 000000 




J 



Figure 3-5 Pool Statistics 
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3.1.6 Assign Table 

Figure 3-6 is a listing of the logical device assignment 

RSX-ilM-PLUS CRASH DUMP ANALYZER V3.0 16-APR-85 

ASSIGN TABLE 


table. 
09 j 15 


System Logicals: 

SY * DR5; 

Block: I Status: (Final) 

EDTINI r SYS$LOGIN:EDTINI 

Block: 1 


User Logicals: 

Terminal: TT5: 

SYSSLOGIN = DR5:[COVERT] 

Block: 2 status: (Final, Privileged) 

Terminal: TT24: 

IN = DR5: 

Block: 1 Status: (Final) 

SYSSLOGIN a DR5:(007,325J 

Block: 2 Status: (Final, Privileged) 

Terminal: TT75: 

HOME a DR5: (7,40) 

Block: l 

DEFCOR a DB3:(61,40) 

Block: l 

DUMPS a LB:(4,54) 

Block: 1 

SYSSLOGIN a DR5:l7,40J 

Block: 2 Status: (Final, Privileged) 

Figure 3-6 Logical Assignment Table 


The Assign Table lists logical assignment table entr 
categories: system logicals and user logicals. The sys 
listing shows the logical name, the equivalence name, the 
blocks, and the status of an assignment. The user logi 
also shows the terminal from which an assignment was made. 


les in two 
tem logicals 
number of 
cals listing 
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3.1.7 Group-Global Event Flags 

Figure 3-7 shows a group-global event flag dump. If there are no 


group-global 

event flags, this dump does not appear. 

I tern 

Description 

1. 

Group number 

2. 

Access count 

3. 

Group-global Event Flag Block dump 

(The last two words are the group-global event flags.) 


RSXMi*-PLU$ CRASH DUMP ANALYZER V4.2 19-APR-85 10117 PAGE 18 

GROUP GLOBAL EVENT FLAGS 


© 


GROUP NUMBER i 

si ACCESS COUNT =177476 

GGEF DUMP t 


000000 

5156660 000401 177476 000015 000000 

GROUP NUMBER ; 

s7 ACCESS COUNT 5006332 


GGEF DUNPs 


0 0 0 0 ? 0 

P00000 000007 006332 000014 000000 


Figure 3-7 Group-global Event Flags 
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3.1.8 Error Log Packets 


ng 


The listing shown in Figure 3-8 contains error loggi 
that resided in memory at the time of the crash. This 
appear if no error log packets were in memory at the 
crash. This data is not written to the Error Log file o 

Item Description 

1. Address of error log buffer 

2. Error log packet entry type code 


information 
page does not 
time of the 
n disk. 


3. Error log packet entry type subcode 

4. Time the packet was logged 

5. Dump of error log packet in octal 


RSX-1lM CRASH DUMP ANALYZER 

V4. 

2 19- 

■APR-85 

t 3 8 SB 

P 

AGE 8 

ERROR LOG 

buffers 









© 








BUFFER 

ADDRESS = 

072304 

ENTRY 

Type code S 000002 ENTRY TYPE 

SUBCODE 

TIME a 

7-JUL-81 

07 : 46:1 

1 

© 





000000 

000000 

000210 

000034 

000055 

000401 

030463 

020040 

003401 

000020 

000025 

000013 

000402 

003521 

003407 

005456 

000106 

000001 

000040 

000046 

046504 

000001 

00000I 

000000 

047115 

052105 

031526 

000060 

041117 

000112 

000000 

000000 

000000 

000001 

064766 

000000 

000100 

011532 

000000 

000000 

000030 

045662 

131574 

000424 

047503 

000120 

000400 

001000 

000003 

000017 

004010 

177000 

000000 

000056 

000140 

101220 

172741 

044702 

000424 

004301 

100301 

000000 

000000 

000160 

000253 

177777 

033065 

022000 

004066 

000000 

010341 

100000 

000200 

101721 

000001 

000001 

105262 

030111 






Figure 3-8 

Error 

Log Packets 




a 000001 


© 
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3.1.9 Low Core Memory Dump (RSX-11M-PLUS Only) 

The listing shown in Figure 3-9 contains a dump of RSX-11M-PLUS low 
core memory, alphabetized by label. 

The following summary lists labels found in RSX-llM-PLUS low core 
memory and their meanings: 

$CRSBF Internal crash stack 

$CRUPC Scratch user program counter (PC) 

$CRUST Scratch user Processor Status Word (PSW) 

$CURPR Pointer to current task priority 

$CXDBL Context switch disable flag 

$DICSV Temporary storage for directive service 

$DXDEP Entry point to dynamic Executive debugger interface 

$DXDK5 Saved KINAR5 for dynamic Executive debugger interface 

$DXDRL Relocation bias for dynamic Executive debugger 

interface 

$HEADR Pointer to current task header 

$PARLV Interrupt recursion level counter 

$RQSCH Pointer to current reschedule pointer 

$SAHDB Bias of current task header 

$SAHPT Virtual address of current task header 

$SAVSP Saved stack pointer 

$SIRWF Supervisor instruction space read/write flag 

$STKDP Stack depth indicator 

$SUPFL Supervisor window flag 

$TKTCB Pointer to current task TCB 


RSX-llM-PLUS CRASH DUMP ANALYZER V3.0 
LOWCORE ALPHABETIZED DUMP 


19-APR-es is»aa 


PACE 3 


SCR3BF 

300000 

000000 


030330 

SRQSCH 

021712 


000000 

000000 


330000 

SSAHDB 

000000 


000000 

000000 


030300 

SSAHPT 

000000 


000000 

000000 


300030 

SSAVSP 

000000 

SCRUPC 

000000 

000000 

SDVDEP 

000300 

SSIRWF 

000 

SCRUST 

000000 

000000 

SDXDK5 

330003 

SSTKOP 

000000 

SCURPR 

021722 

000000 

SOXDPL 

330303 

SSUPFL 

000 

SCXDBL 

000 

000000 

SHEADR 

030030 

STKTCB 

000000 

SD ICS V 

000000 

000000 

SPARLV 

177777 




Figure 3-9 Low Core Memory 
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3.2 OPTIONAL INFORMATION 

CDA gives you additional information when you use the analysis 
switches described in Chapter 2. Figures 3-10 through 3-24 illustrate 
the output that CDA provides when you use these switches. 


3.2.1 Active Tasks 


The listing shown in Figure 3-10 contains active task 


The 


- — - -- — —’ lilt* l. 1 VU • 

Receive Queue, AST Queue, Receive-by-Reference Queue, and 


Offspring Control Block sections of this example appear 


--—-- *-J. LUC 

has them; otherwise, they are suppressed. Section 3.2.2 


task - --, 

describes the additional information in the active task 
the active task is MCR. 


I tern 
1 . 
2 . 

3. 

4. 

5. 

6 . 

7. 

8 . 
9. 

10 . 

11 . 

12 . 

13. 

14. 


information, 


only if the 


listing when 


Description 

Task name 

Address of Task Control Block (TCB) for the task 
Name of the partition in which the task runs 
Address of Partition Control Block (PCB) 

Base address for the partition in which the task runs 
Device that contains task image 

Beginning logical block number (LBN) of the task on the 
device 

Running priority 

Number of outstanding QIO requests 


Current UIC (either the login UIC or the U 
with a SET command) 


IC specified 


Physical name of task’s pseudo device 

Maximum size of task image in 32(decimal)-word blocks 

State of local event flags for task 

First status word (blocking bits), using the following 
three-letter codes: 

-EXE - Task not executing 

RDN - I/O rundown in progress 

CIP - Task blocked for checkpoint in progress 
MSG - Abort message being output 

CKR - Task has checkpoint request (RSX-11M-PLUS only) 
BLC - Increment blocking count 
STP - Task stopped by CLI command 
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Item Description 

15. Second status word (state bits) , using *the following 
three-letter codes: 


AST - 

Asynchronous system trap (AST) in progress 

SIO - 

■ Task stopped for buffered I/O 

DST - 

■ AST recognition disabled 

•- 

AFF - 

- Task installed with affinity 

-CHK - 

■ Task not checkpointable 

SEF - 

- Stopped for event flag 

REX - 

- Exit AST specified 

HLT - 

- Task being halted 

ABO - 

- Task marked for abort 

STP - 

- Task stopped 

SPN - 

- Task suspended 

WFR - 

- Task in wait-for state 


16. Third status word (attribute bits) , using the following 
three-letter codes: 


ACP - 

- Task is an Ancillary Control Processor (ACP) 

PMD • 

- Task not dumped on synchronous abort 

CMD ■ 

- Task is executing a CLI command 

REM ■ 

- Remove task on exit 

PRV ■ 

- Task is privileged 

MCR ■ 

- Task requested as an external MCR function 

SLV 

- Task is a slave task 

CL I 

- Task is a command line interpreter 

RST 

- Task is restricted 

NSD 

- Task does not allow send data 

CAL 

- Task has checkpoint space in task image 

ROV 

- Task has resident overlays 

NET 

- Network protocol level 

GFL 

- Group-global event flags are locked 


SWS - Reserved for Software Services 
MPC - Mapping change with outstanding I/O 
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Item 


17. 

Fourth 
codes: 


MUT 


LDD 


PRO 


PRV 


DSP 


SNC 


Description 


the GIN directive 


18. 


Octal dump of TCB in offset mode 


RECEIVE QUEUE (if the task has one) 

19. Starting address of receive block 

20. Name of task 

21. Octal dump of receive block in offset mode 

OFFSPRING CONTROL BLOCK (OCB) LIST (if the task has one) 

22. Exit event flag number of offspring task 

23. Name of parent task 

24. Octal dump of offspring control block in offset mode 


ASYNCHRONOUS SYSTEM TRAP (AST) QUEUE (if the task has one) 

If a task has an AST Queue, CDA lists its contents. If the 
has a Receive Queue, the AST Queue appears immediatel 
Receive Queue on the output listing. If the task does 
Receive Queue, the AST Queue is listed after the fourth 
information (the example in Figure 3-10 does not inclu 
Queue). 


task also 
y after the 
not have a 
status word 
de an AST 


An item appearing in the AST queue may be one of the following: 

• Unsolicited AST 

• Floating point AST 

• Receive data AST 


• Receive-by-reference AST 

• Parity error AST 

• Requested exit AST 

• Power fail 


• CLI command arrival AST 


• Buffered I/O AST 


3-23 









ANALYSIS LISTINGS 


• Offspring task AST 

• Segmented buffered I/O completion AST 

• Task force trace bit trap AST 

• Delayed I/O completion AST 

• Group-global rundown AST 

• I/O request packet 

Address of AST block 

- A 2-byte indicator (The high-order byte is an offset into 
the header of the AST control block; the low-order byte is 
the length of the AST control block in bytes.) 

NOTE 

If the low-order byte is negative, the block is not 
an AST block, but an I/O request packet internal to 
the system. If the low-order byte is 0, the block 
is an unsolicited character AST. 


Number of bytes allocated on task stack 
Entry point of AST routine 
Number of AST parameters 

Octal dump of the AST block in offset mode (On RSX-11M-PLUS 
systems, two additional negative offset words appear in the 
dump.) 


RECEIVE-BY-REFERENCE QUEUE (if the task has one) 

If a task has a Receive-by-Reference Queue, CDA lists its contents. 
If the task also has an Offspring Control Block list, the 
Receive-by-Reference Queue appears immediately before the OCB list on 
the output listing. If the task does not have an OCB list, the 
Receive-by-Reference Queue is the last list on the Active Tasks 
listing (the example in Figure 3-10 does not include a 
Receive-by-Reference Queue). 

Address of Receive-by-Reference Queue Block 

Address of the Task Control Block (TCB) for the task that 
initiated the Send by Reference 

Contents of event flag mask 

Address of event flag mask 

Pointer to created attachment descriptor 

Offset into partition as specified in window definition 

Length to be mapped 

The receiving task's access rights to region being mapped 
Octal dump of Receive-by-Reference Block in offset mode 
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R3X-11M-PLUS CRASH DUMP ANALYZER V3.0 19-APR-85 13IP2 PACE 13 

ACTIVE TASKS 


...IDR © 

© ® ® 

TCB AOORESS ■ 111650 PAR « SYSPAR PCB ADDRESS a 111434 

© © ® 

LOAD ADDRESS ■ 004616B0 LOAD DEVICE a LB0I LBN a 00076636 

© © © © 

PRI ■ 24S. I/O COUNT ■ 0, UIC a [1#24J TI C001 

@ © 

PAX SIZE ■ 000035 EVENT FLAGS » <l-U> 000001 < 17-32> 000000 

T.STATl 000000 (14) 

T.ST2J 020020 -CHK STP © 

T.3T3I 050200 -PHD PRV NSD @ 

T.3T4I 000000 @ 

TCB OUMPl 


000000 

000000 

000370 

000000 

131574 

045662 

000000 

1 

111662 

000000 


000020 

111666 

000001 

000000 

022370 

111300 

000000 

fi 

J2002B 

050200 


000040 

000370 

076636 

031420 

111434 

000035 

033500 

1 

111426 

111426 


000060 

000000 

000000 

000000 

000001 

111672 

000035 

fi 

J00000 

000000 


000100 

000000 

111750 

000000 

111754 

000000 

000000 

fi 

J00000 

000000 



RECEIVE QUEUE 


© 

RECEIVE BLOCK ADDRESS « 062000 


© 

TASK NAHE b TUSKRD 


000000 

000020 

000060 


000000 

140002 

046522 


100143 

133406 

000000 


043624 

000000 


062640 

000000 


050210 

000000 


016000 

000000 


121502 024172 ^ 

000000 000000 ^ 


OCB LISTi 


EXIT EVENT FLAG (O.EFN) b 000000 @ 


PARENT TASK NAME s QmG... (g 
OCB DUMP| 


000000 

000020 


000000 

000000 


000000 

000000 


106424 
000C*00 


121350 

000000 


000000 

000000 


000000 

000000 


0661 17 13157a @ 


Figure 3-10 Active Tasks (Truncated) 
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3.2.2 Active Task (MCR) 

The active task listing for the MCR task (MCR...) contains more 
information than the active task listing for other tasks. Figure 3-11 
shows a listing in which the first 17 items are the same as those in 
Figure 3-10. The following list describes only the items that are 
different from those in the previous figure, when MCR... is the 
active task. 

Item Description 

1. Address of MCR input buffer 

2. Address of Unit Control Block (UCB) of the requesting 
terminal 

3. Device name and unit number of the terminal that sent 
block to MCR (ASCII characters) 

4. Octal dump of the MCR input buffer in offset mode 

5. Address of command buffer 

6. Address of Task Control Block of the requesting task 

7. ASCII dump of command buffer 

8. Octal dump of command buffer in offset mode 
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RSX-UM-PLUS CRASH DUMP ANALYZER V3.0 
ACTIVE TASKS 


19-APH-85 16:23 


MCR•«t 


TCB ADDRESS * 114610 
LOAD ADDRESS a O01744O0 
PRI ■ 160, I/O COUNT s 0, 


PAR a SYSPAR PCB ADDRESS a 037050 

LOAD DEVICE a LB0 LBN s 00073747 

UIC a [1,24] TI a TT3 


MAX SIZE 

a 000100 

EVENT 

FLAGS a 

<1"16> 

000001 

<17-32> 

0410000 

1 

T.STATl 

000000 








T.ST2I 

000020 STP 








T.8T3I 

051300 -PMD PRV 

CLI NSD 

CAL 





TCB DUMP 









000000 

000000 

0002410 

000000 

050712 

1315741 

000000 

11462 

2 

000020 

1 141626 

000001 

0410000 

024552 

113760 

000000 

00002 

0 

0000U0 

0002410 

0737417 

035636 

037050 

000100 

112330 

036046 

000060 

003000 

000000 

000000 

114674 

000000 

1 141700 

000000 

000100 

0041256 








RECEIV 

E QUEUE 











© 



© 



COMMAND LINE INPUT 

BUFFER 

ADDRESS 

a 036730 UCB 

a 030245 


TT50 1 

© 








000000 

043214 

0302415 

035770 

000053 

000020 

000000 

030244 

000020 

120430 

031750 

1 410030 

000000 

001751 

1410010 

000027 

0000410 

000040 

000000 

000000 

000000 

000000 

000000 

300000 

000060 

026226 

000000 

000000 

1 1 741041 

005627 

300362 

000000 

000100 

000000 

1 1 32341 

000010 

037050 

000000 

036120 

036120 


MCR COMMAND BLOCKS 
© 

BUFFER ADDRESS a 103100 
ASN DB01:aSY:/LOGIN0 


© 

TCB a 102730 


000000 

000300 

102733 

051501 

020116 

041104 

030460 

036472 

00H020 

027472 

047514 

044507 

015516 

026226 

000000 

00000 

0 

000tf40 

024600 

000420 

000000 

000420 

000000 

103020 

00001 

0 

000060 

000000 

060440 

060440 

060370 

103370 

000114 

00061 

2 

000100 

170000 

126102 

000000 

000000 

000000 

000000 

00001 

2 

000123 

000000 

000000 








Figure 3-11 Active Task (MCR) 


PAGE 10 


000000 

051300 

036046 

000000 


000400 

000361 

000214 

000362 

000000 


054523 

117404 

104074 

033406 

000137 
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3.2.3 Task Headers 

Figure 3-12 is an example of a task header listing. The following 
list describes its contents. 

Item Description 


1 . 

Task name 

2. 

Pointer to the first word in the task header 

3. 

Pointer to the first word in the Task Control Block (TCB) 

4. 

Contents of Processor Status Word (PSW) and Program 
Counter (PC) 

5. 

Contents of the general registers 

6. 

Initial contents of the PSW, the PC, and the stack 
pointer (SP) 

7. 

The task header size in decimal bytes, the number of 
windows required to map the task, and the number of 
logical unit numbers assigned to the task 

8. 

Current and default UIC 

9. 

Pointer to number of window blocks 

10. 

Pointer to header guard word 

11. 

Work area extension vector pointer 

12. 

Priority difference for swapping 

13. 

Directive Status Word 

14. 

Address of File Control Services (FCS) impure area 

15. 

Address of FORTRAN impure area 

16. 

Address of overlay impure storage 


LOGICAL UNIT TABLE 


17. 

Logical unit number (LUN) 

• 

00 
r—1 

Physical device name before redirect 

19. 

Window pointer in header 
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Item 

20 . 


21 . 

22 . 

23. 

24. 

25. 

26. 


Description 

Low-order byte of this word indicates the number of map 
entries active; the high-order byte has the following bit 
assignments: 


WI.RDV=400 - read virtual address allowed i 
WI.WRV=1000 - write virtual block allowed i 
WI.EXT=2000 - extend allowed if set 
WI.LCK=4000 - set if locked against shared 
WI.DLK=10000 - set if deaccess lock enabled 
WI•BPS=100000 - bypass access interlock if 
Address of File Control Block 
File number 
File sequence number 
File Control Block status word 
Number of accesses 
Number of block locks 


f set 
f set 

access 

set 


WINDOW BLOCKS 

27. The name of the partition in which the task runs 

28. The virtual limits of the task 

29. Address of attachment descriptor 

30. Window size in 32-word blocks 

31. Offset into partition 

32. Address of the first Page Description Register (PDR) used 
to map the window 

33. Number of PDRs used 

34. The contents of the last PDR used 

35. Octal dump of task header in offset mode 
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RSX-11M CRASH DUMP ANALYZER V4.2 19-APR-85 

TASK HEADERS 


15113 


PAGE 37 


TKTN 0 

. © © 

HEADER ADDRESS * 076060 TCB ADDRESS s 107134 

PS«170000 PCsl22630 @ 

R0*120254 R1 <000065 R2*U00060 R3»14k)354 Ra«120702 R5»051024 SP»120226® 
INITIAL PS ■ 170017 INITIAL PC * 120764 INITIAL SP = 120230© 

HEADER SIZE s 102, NO. OF WINDOWS » 1. NO. OF LUNS « 1.® 


CURRENT UIC s [1,24] 

© ( 10 ) 

H.WND s 076162 H.GARD e 076224 

© © 

DSW s 000001 H.FCS * 000000 


DEFAULT UIC = [1,24]® 

© 

H,V E X Ts 000000 

© 

H,FORT s 000000 


( 12 ) 

H.SPRI S 5, 

(jg) 

H.OVLY S000000 


LOGICAL UNIT TABLEJ 


(17) (18) (19) 

# DEV WINDOW 

* mmm rnmmmmm 

1 T10| 000000 


WINDOW BLOCKSi 


( 20 ) 

W.CTL 


(g) <& (?3) © 

W.FCB F.FNUM F.FSEQ F.STAT 


(25) 

NAC 


© 

NLCK 


© 

PAR 

@ 

VIRT LIMITS 

1 

ATT 

© 

DESC WND 

© 

SIZE 

© 

OFFSET 

© 

1ST PDR 

® © 

NO. LAST PDR 

TKNPAR 

120000 127777 045220 000100 

000000 

177612 

1 

037406 

HEADER 1 

000000 

120226 

000146 

140354 

163500 

000424 

000424 

170017 

120764 

000020 

120230 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000040 

000000 

000000 

076162 

000001 

000000 

000000 

000000 

000000 

000060 

000005 

000000 

000000 

000000 

000000 

076224 

000001 

044570 

000100 

000000 

000001 

114450 

120000 

127777 

045220 

000100 

000000 

000120 

000140 

000612 

000065 

037406 

120254 

170000 

000000 

122630 

051024 

120702 

140354 

000060 


35 


Figure 3-12 Task Headers (Truncated) 
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3.2.4 Command Line Interpreter Parser Block (CPB) 

The listing shown in Figure 3-13 contains the Command Line Interpreter 
Parser Block for MCR. The listing corresponds to the following items: 

item Description 

1. Task name of the CLI 

2. Starting address of the CPB 

3. C•PSTS, which is the CPB status word 

4. Dump of the CPB in octal 


RSX-11M CRASH DUMP ANALYZER V4,2 19-APR-85 

CLI PARSER BLOCKS 


15: 1 3 


PAGE 9 


CLI TASK NAME MCR... (T) 

CPB ADDRESS = 010472 CLI NAME = MCR ( 2 ) 

C.PSTSl SGL ( 3 ) 

CPB DUMP: 

000000 110160 050712 000000 000040 003U04 005015 000076 005015(4) 

000020 041515 037122 000000 

Figure 3-13 CLI Parser Blocks 


3.2.5 Partition Information 

CDA outputs partition information in two segments. The listing shown 
in Figure 3-14 contains system partition information, and the listing 
shown in Figure 3-15 represents individual partition information. The 
following list describes elements of Figure 3-14. Individual 
partitions include Attachment Descriptors and Wait Queues when they 
apply. 

Item Description 

1. Partition names 

2. Partition Control Block (PCB) address 

3. Base address of partition in memory 

4. Size of the partition 

5. Type of partition 

6. Task or tasks occupying the partition 
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RSX» 11M CRASH DUMP ANALYZER V4.2 19-APR-85 15113 PAGE 5a 

PARTITION INFORMATION 


MEMORY map 


® 

® 

® 

® 

® 

® 

PARTITION 

PCB ADR 

BASE 

SIZE 

type 

OCCUPIED BY 








<EXEC> 


00000000 

00044700 




<P00L> 


000au700 

00050100 




CEXPAR 

114734 

00115000 

00003000 

MAIN 

COMMON 


TTPAR 

114670 

00120000 

00040000 

MAIN 

DRIVER 

TTl 

EXC0M1 

1 14624 

00160000 

00014600 

MAIN 

COMMON 


EXC0M2 

iia560 

00174600 

00006100 

MAIN 

COMMON 


SYSPAR 

114514 

00202700 

00010000 

MAIN 

task 

MCR # • # 

TKNPAR 

114450 

00212700 

00010000 

MAIN 

TASK 

TKTN 

DRVPAR 

114404 

00222700 

00030200 

MAIN 

SYS 



114340 

00222700 

00002100 

SUB 

DRIVER 

DB: 


114240 

00225000 

00001200 

SUB 

DRIVER 

DKj 


114140 

0022620 a 

00003000 

SUB 

DRIVER 

DM i 


114040 

00231200 

00003000 

SUB 

DRIVER 

DRl 


1 13740 

00234200 

00001000 

SUB 

driver 

EM | 



00235200 

00000100 

<HOLE> 



1 13640 

00235300 

00001100 

SUB 

DRIVER 

DTj 


1 13540 

00236400 

00001400 

SUB 

DRIVER 

DXi 


113440 

00240000 

00002200 

SUB 

DRIVER 

Di: 


113340 

00242200 

00002600 

SUB 

DRIVER 

DDl 


113240 

00245000 

00001300 

SUB 

driver 

IP* 


113104 

00246300 

00004300 

SUB 

driver 

MM | 


112450 

00252600 

00000300 

SUB 

driver 

COi 

ldrpar 

112404 

00253100 

00002500 

main 

task 

LOR... 

BASIC2 

112340 

00255600 

00040000 

Main 

COMMON 


FC3RES 

112274 

00315600 

00040000 

main 

COMMON 


TSTPAR 

112230 

00355600 

00100000 

main 

TASK 


GEN 

112164 

00455600 

03322200 

main 

SYS 



045620 

00455600 

00024000 

SUB 

TASK 

D62FCP 


057144 

00501600 

00025500 

SUB 

TASK 

NET ACP 



03527300 

00005200 

< HOLE > 



064060 

00534500 

00023300 

SUB 

TASK 

RMHACP 


053004 

00560000 

00005200 

SUB 

TASK 

CA.T6 


073534 

00565200 

00005200 

SUB 

TASK 

CA.T30 



00572400 

00005700 

<HOLE> 



045010 

00600300 

00005700 

SUB 

TASK 

PMT... 


Figure 3-14 Partition Information 
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Each item in the following list describes a correspondingly numbered 
item in Figure 3-15. 

item Description 

PARTITION CONTROL BLOCK 


1 . 


2 . 


3. 


4. 


5. 

6 . 


7. 


8 . 


9. 


10 . 


11 . 


12 . 


Partition name 

Pointer to the first word of the PCB 
Type of partition 
Name of main partition 

Physical base address of partition in 32-word blocks 
Partition size in 32-word blocks 

Pointer to the first word of the TCB of attached task 
Partition protection word (mapped system only) 

Priority of attached task or partition 
I/O count of attached task or partition 

Partition status flags, using the following three-letter 
codes: 

OUT - Partition is out of memory 
CKP - Partition checkpoint in progress 
CKR - Partition checkpoint is requested 
CAF - Checkpoint space allocation failure 
-CHK - Partition is not checkpointable 
FXD - Partition is fixed 
LFR - Last head of region failure 
PER - Parity error in partition 
L10 - Marked by Shuffler for long I/O 
NSF - Partition cannot be shuffled 
COM - Library or common block 

DEL - Partition should be deleted when not attached 
Octal dump of PCB in offset mode 
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Item Description 

ATTACHMENT DESCRIPTOR 


13. 

Address of attachment descriptor 




14. 

Partition to which attachment occurs 




15. 

Name of attaching task 




16. 

PCB attachment queue thread word 




17. 

TCB attachment queue thread word 




18. 

Priority of highest priority task 
partition 

attached 

to 

this 

19. 

I/O count of attached task on RSX-11M 
of attached partition on RSX-llM-PLUS 

systems; 
systems 

I/O 

count 

20. 

Number of times task is mapped through this 
descriptor 

attachment 

21. 

Attachment descriptor status byte, using the 
three-letter codes: 

following 


DEL - Task has delete access 

EXT - Task has extend access 

WRT - Task has write access 

RED - Task has read access 

PRO - TCB is secondary pool TCB bias 

SPB - Cache bypass request 

RBP - Request to not bypass cache 

22. Octal dump of attachment descriptors in offset mode 

PARTITION WAIT QUEUE 

23. Name of the task awaiting access to the partition 

24. Address of TCB for the task 

25. TI: device for the task 

26. Task's priority 

27. Second status word (state bits)—same as item 15 of the 
active task dump (Section 3.2.1) 

RSX-llM-PLUS SYSTEMS ONLY ADDITIONAL ITEM DESCRIPTION 

28. Resident mapped task count 

29. Wait queue contains partition description rather than 

task description 
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PARTITION PCB ADR 

••••••••• 

DRVPAR 11 7270 

P.STATj SYS DRV 


type 

main 

BASE 

SIZE 

P.TCB 

PRO 

PRI 

m m m m 

mm mm 

• • • • 

• • • • 

• • ■ • • 

• •• 

m m m 

sue 

DRVPAR 

am 312 

000060 

040754 

000000 

0. 


IOC 

• •• 

0. 


000000 

000020 

000040 


000000 00(3000 015746 062072 000000 117734 001312 

(100000 000000 000000 040754 000060 000000 000000 

117326 


000060 

000000 


© 

© 

© 

© 

© 

© 

© 

© 

PARTITION 

PCB ADR 

TYPE 

MAIN 

BASE 

size 

P.TCB 

PRO 


• 

• 

1 

• 

» 

I 

• • • • 

• mmm 

mm mm 

■ m m m 

mmmmm 

• • • 

SYSPAR 

11 7070 

MAIN 

SYSPAR 

001372 

000105 

115264 

000000 


P.STATj © 



PRl JOC 

••• mmm 

n. a. 


aapioya 

aaaa2a 

aacnoa 


H7a3a aaaaaa 
115760 115760 
001760 


075273 062072 000000 117070 001372 
100200 115260 000000 002760 000000 


000105 

002000 


© 


WAIT QUEUEt 


© 

@ 

© 

© 

© 

TASK 

mm mm 

TCB ADR 

TI 

T.PRI 

state BITS (T.ST2) 

FUACP 

115760 

CO0 

149. 

CAP STP 


ATTACHMENT DESCRIPTORS: 


© 

ADDRFSS 

© 

PARTITION 

© 

ATT TASK 

© 

A.PCBL 

© 

A.TCBL 

© 

PRI 

© 

IOC 

© 

map count 

042000 

A . ST AT 1 

SYSPAR 

WPT RED @ 

...MCR 

001760 

000000 

mmm 

160. 

0. 

0. 

000000 

001760 000200 115260 

000000 

000003 

117070 @ 



Figure 3-15 Partition Control Blocks 
and Attachment Descriptors 
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RSX-UM-PLUS crash 

DUMP 

analyzer 

V3.0 

?.may-85 

15136 


PAGE 63 

PARTITION INFORMATION 














® 

NAME PCB ADR 

TYPE 

MAIN 

BASE 

SIZE P.OWN 

PRO 

PRI 

RMCT 

GEN 1174H4 

MAIN 

GEN 

00443a 

047346 000000 

000000 

0. 

0. 


P t ST AT l 00000? 


P.ST2* 000000 


000000 000000 000000 026226 000000 055724 117404 004432 047346 

000020 061774 063170 000000 000000 000000 000000 000000 000000 

000040 0000P0 


WAIT QUEUE t ® 


NAME 

PCB ADR 

TYPE 

MAIN BASE 

SIZE P.TCB PRO 

PRI 

RMCT 

BAP2 

061774 

SUB 

GEN 

013731 000373 061670 000000 50. 

0. 

P•ST AT ! 

140010 

OUT 

CKP 

DEL 




000000 

000020 

000040 

063170 
, 000000 
037360 

00006 a 

00037 a 

026226 

274114 

000000 063170 117404 

061670 140010 063474 

012731 

000000 

000372 

037360 


Figure 3-15 (Cont.) Partition Control Blocks 
and Attachment Descriptors 


3.2.6 Common Block Directory 

CDA lists partition information, status words, and Partition Control 
Blocks for each installed, named common region. The listing in Figure 
3-16 shows a Common Block Directory entry. The following list 
describes the items in Figure 3-16. 

Item Description 

1. Name of the installed common region partition 

2. Address of Partition Control Block (PCB) 

3. Type of partition 

4. Name of the main partition 

5. Physical base address of partition 

6. Size of partition in 32 (decimal)-word blocks 

7. Owning UIC of the common region 

8. Partition protection word 
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Item 

9. 

10 . 

11 . 

12 . 

13. 

14. 

15. 


Description 

Resident mapped task count 

Partition status words (refer to Section 3.2.4) 

Octal dump of PCB 

Address of PCB of the common task image file 

Address of Unit Control Block (UCB) of the device on 
which the common resides 


Starting logical block number (LBN) of the 
image file 

Word that always contains a 0 

V3.0 2-MAY-85 14|03 


RSX-UM-plus CRASH DUMP ANALYZER 
common BLOCK directory 

© 

NAME 


® © © © 

PCB ADR TYPE MAIN BASE 


© 

SIZE 


© 

PRO 


common task 


PAGE 75 


© 

PRI RMCT 


© 

P.OWN 

•■•••••- ---- «... ..... 

BASIC2 043.25a $U0 GEN 017747 000400 001454 000000 0, 0, 

P.STATj 000200 COM 

P.ST2J 000006 APR 


•® 


000000 000000 000000 006273 034330 040370 117404 017747 

000020 ~ 

0 0 \a (/• a 0 


000400 


^43312 1300008 !,<t52at ' 00 1 u 54 00020P 000006 000000 000000 V© 


common TASK image FILE PCB 

© © © 

PCB ADR P * UCB P.LBN 


© 

P.REL 


045240 


035662 000001,023653 000000 


NAME PCB ADR TYPE main BASE SIZE 

FCSSUP 053550 SUB GEN 

P.STAT: 1 0 0 2 0 y 1 OUT COM 

P•ST 2 I 000000 


P.OWN PRO PRI RMCT 

mmmmm mm* mmm- mm mm 

000000 000212 000401 000000 0, 0 , 


000000 000000 000400 023013 075030 000000 11740a 000000 000212 

00P!0U(» MS3606 000212 040114 000401 100200 000000 000000 000000 


COMMON TASK IMAGE FILE PCB 

PCB ADR P.UCB P.LBN P.REL 

i3401 14 035662 000002# 001071 000000 

Figure 3-16 Common Block Directory 
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3.2.7 Device Information 

CDA lists information on all devices known to the system. The listing 
in Figure 3-17 shows a typical terminal device listing with an I/O 
packet. The Terminal Status Words (items 15, 16, and 17) appear only 
in listings for terminal devices. The codes for these items apply 
only to the full-duplex terminal driver. The section labeled I/O 
REQUEST PACKETS appears only for devices that have an I/O request in 
progress or an I/O request queued at the time of the system crash. 
The following list describes the items in Figure 3-17. 


Item 

1 . 

2 . 

3. 

4. 

5. 
6 • 

7. 

8 . 
9. 

10 . 


11 . 


Description 

Device name 

Address of offset 0 in Unit Control Block (UCB) 

Address of offset 0 in Device Control Block (DCB) 

Address of offset 0 in Status Control Block (SCB) 

Device to which unit is redirected 

Name of Ancillary Control Processor (ACP) 

Name of attached task 

Pointer to the UCB name of the owning terminal 
UIC used to log into the system 

Unit status byte, using the following three-letter codes 
BSY - Unit is busy 
-MNT - Unit is not mounted 
FOR - Unit is mounted as a foreign volume 
MDM - Unit is marked for dismount 
PWF - Power fail occurred 
WCK - Write check enabled 
SPU - Unit is spinning up 
VV - Volume is valid 


Unit status extension byte, 
three-letter codes: 


using the following 


OFL - Unit off line 
-RED - Unit is not redirectable 
PUB - Unit is public device 
UMD - Unit attached for diagnostics 
PDF - Privileged diagnostic functions only 
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Item 

12 . 


13. 


14. 


Description 


Control Processing flags, using 
three-letter codes: 


the 


following 


-ALG - Byte alignment not allowed 
NPR - Device is a NPR device 
QUE - Call driver before queuing 

PWF - Always call driver at power fail entry point 

ATT - Call driver on attach/detach 

KIL - Always call driver at I/O kill 

First device characteristics word, using the following 
three-letter codes: 

REC - Record-oriented device 

CCL - Carriage-control device 

TTY - Terminal device 

DIR - File-structured device 

SDI - Single directory device 

SQD - Sequential device 

MSD - Mass storage device 

EXT - Unit on extended 22-bit UNIBUS controller 
UMD - User-mode diagnostics supported 
MBC - MASSBUS device 
SWL - Unit software write locked 
ISP - Input spooled device 
OSP - Output spooled device 
PSE - Pseudo device 

COM - Device is mountable as COM channel 
F11 - Device is mountable as Files-11 device 
MNT - Device is mountable 


Second device characteristics word, using the fol 
three-letter codes: 

DH1 - Unit is a multiplexer 

DJI - Unit is a DJ11 

RMT - Unit is remote 

HFF - Unit handles hardware form feeds 
NEC - Solicited input not echoed 


lowing 
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Item Description 

CRT - Unit is a CRT 

ESC - Unit generates escape sequences 
-LOG - User not logged in on terminal 
SLV - Unit is a slave terminal 
DZ1 - Unit is a DZll 

HLD - Terminal is in hold screen mode 

AT. - MCR command AT. is being processed 

PRV - Unit is a privileged terminal 

L3S - Unit is a LA30S terminal 

VT5 - Unit is a VT05B terminal 

LWC - Lowercase to uppercase conversion 

15. Terminal status word, using the following three-letter 
codes: 

RST - Read with special terminators in progress 

RUB - Rubout sequence (non-CRT) in progress 

ESC - Escape sequence in progress 

RAL - Read pass all in progress 

RNE - Echo suppressed 

CTO - Output disabled 

OBY - Output busy 

IBY - Input busy 

BEL - Bell pending 

DPR - Defer processing of character in buffer 

DEC - Defer echo of character in buffer 

DSI - Input processing disabled 

CTS - Output stopped by CTRL-S 

USI - Unsolicited input in progress 

OBF - Buffered output in progress 

IBF - Buffered input in progress 
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Item 

16. 


17. 


Second terminal status 
three-letter codes: 


Description 

word using the following 


ACR - Wrap-around required 

CR - Trailing carriage return required on output 

BRQ - Break-through write is queued 

WRA - Control for wraparound 

SRQ - Special request is queued 

WRB - Low bit in 52-WRA bit pattern 

ORQ - Output request is queued 

IRQ - Input request is queued 

HFL - Horizontal fill required 

VFL - Vertical fill required 

HHT - Hardware horizontal tab is present 

HFF - Hardware form-feed is present 

FLF - Force line feed before next echo 

FDX - Line is full duplex mode 

Fourth terminal status word, using the following 
three-letter codes: 

RAL - Terminal is in read-pass-all mode 
WES - Task waiting for escape sequence 
RPO - Read with prompt output in progress 
TAB - Type-ahead buffer allocation requested 
8BC - Pass eight bits on input 
ABD - Autobaud speed detection enabled 
RCU - Restore cursor 

ABP - Autobaud speed detection in progress 

WAL - Terminal is in write-pass-all mode 

VER - Last character in type-ahead buffer has a parity 
error 
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Item Description 


BCC 

- Last 

character 

in 

type-ahead 

buffer 

has 

a framing error 

DAO 

- Last 

character 

in 

type-ahead 

buffer 

has 

a data overrun 


error 

PCU - Position cursor 


NOTE 

On RSX-11M systems that use the half-duplex 
terminal driver, CDA dumps two terminal status 
words. 

UNIT CONTROL BLOCK 

18. Octal dump of Unit Control Block (UCB), including 
negative offsets, and octal dump of UCB extension if a 
UCB extension is present 

DEVICE CONTROL BLOCK 

19. Octal dump of Device Control Block 


STATUS CONTROL BLOCK 

20. Octal dump of Status Control Block 


I/O REQUEST PACKETS 

21. Address of the first word of the I/O packet 

22. Name of the task requesting I/O 

23. Priority of the task requesting I/O 

24. Event flag number used to signal I/O completion 

25. Logical unit number used by requesting task 

NOTE 

If the task was checkpointed while the packet was 
queued, this number may not be correct. If the 
address in I.LN2 is within the task header, the 
logical unit number is correct. 

26. I/O function codes (for detailed information on the legal 
I/O function codes for each device, refer to the 
RSX-11M-PLUS I/O Drivers Reference Manual) 

27. Status of the I/O request - current or queued 

28. Octal dump of I/O request packet in offset mode 

29. I.LN2 - pointer to the second word of the LUN 
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RSX-11M CRASH DUMP ANALYZER 
DEVICE INFORMATION 

v«. 

2 2- 

MAV-P5 

15113 

PAGE 110 

TTlll 









UCB ADR 

040<I7<| 

DCB ADR 

••••••» 

037630 

SCB ADR 

044266 

REDIRECT ACP ATT OWNER LOGIN UIC 

•••••••• •• • • •• mmmmm mmmmmmrnmm 

...MAI NONE [1 $ 37] 

U,STS | 









U,ST2t 









U.CTLi 

QUE PWF 

ATT KIL 







U.cwi 1 

tty ccl 

REC 







U.CW2I 

DH1 CRT 

PR V L*C 







U.TSTAl 

IBY 

IBF 







U.TSTA+21 ACR 

ORQ IRQ 

HHT 

FLF 





U, TSTA + 4 | TAB 








UNIT CONTROL BLOCKi 







040466 

040506 

040526 

040546 

000000 

102011 

000100 

000000 

003437 

000335 

141730 

000000 

0^0000 

000120 

000030 

000000 

037630 
044266 
000001 

04047 4 
056604 
013400 

000474 

145100 

003437 

000010 

100200 

000015 

000007 

050301 

000004 

UNIT CONTROL BLOCK EXTENSION: 






145100 

145120 

145140 

075670 

127147 

000000 

146730 

000001 

013400 

146734 

146734 

000000 

000044 

146470 

023531 

000054 

000000 

146730 

000000 

000000 

002400 

000000 

000022 

DEVICE 

CONTROL BLOCK: 







037630 

037650 

044434 

160000 

037674 

000000 

052124 

000007 

030001 

000000 

000060 

000001 

121274 

000006 

163177 

114670 

000130 

status 

CONTROL BLOCK: 







044260 

044300 

044320 

100200 

160020 

044316 

000011 

067454 

035240 

000004 

031000 

001000 

000000 

170500 

000002 

044266 

000000 

160040 

034240 

000000 

001000 

001200 

000000 

000000 

I/O REQUEST PACKETSl 







packet 

ADR REQUESTOR 

PRI 

EFN 

LUN FUNCTION 

CODE 

STATUS 

075670 

.MAI 

65. 

32. 

5. 

IO.RLB 


INPUT 

000000 

000020 

0 0 0 0 a 0 

0 0 0 A 0 0 

1 4 01' 2 0 
000000 

132*101 

01 ? 0 0 0 0 

075624 

05660a 

000572 

074354 

140040 

040474 

000120 

301000 

100000 

057220 

000000 

017645 

000056 

Figure 3-17 

Device Information and 

I/O Packet (Truncated) 
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3.2.8 System Task Directory 

CDA scans the System Task Directory and outputs the information 
contained in Figure 3-18. The information in this format is identical 
to the first 17 items described in Figure 3-11 of this manual. 


RSX-UM CRASH DUMP ANALYZER V4,2 S-PAY-SS 15li5 

SYSTEM TASK DIRECTORY 


« LDR , 


TCB ADDRESS « 041572 PAR a LDR p CB ADDRESS a 041536 

LOAD ADDRESS a 00000000 LOAD DEVICE » LB0 LBN a 00000000 


PRI a 248, I/O 

COUNT a 

0, UIC a [1, 

11 TI 

s CO0 



MAX SIZE a 000000 

event 

FLAGS = 

<1- 16> 

000001 < 

17-32> 

000000 


T,ST AT i 








T,ST21 -CHK FXD 

STP 







T.ST3I PRV 








000000 000000 

000020 041610 

000040 000370 

000060 000000 

000370 

000001 

000000 

000000 

000000 

000000 

041354 

000000 

127414 

041304 

041536 

041656 

015754 

114564 

000000 

000000 

000000 

000000 

115264 

041662 

041604 

022020 

000000 

000000 

000000 

010000 

041646 

000000 


TKTN 


TCB ADDRESS a n«564 PAR ■ 3YSPAR PCB ADDRESS a H7074 


LOAD ADDRESS a 00137200 LOAD DEVICE a LB0 LBN a 00057410 

PRI a 248, I/O COUNT a 0, UIC a [0,0] TI a NONE 

M *X gIZE ■ 000105 EvENj FL AGg a «1-16» 000000 < 17-32> 000000 

T.STATi -EXE OUT 

T.ST21 

T.ST3I -PMD PRV CAL 


000000 

000000 

000370 

000000 

077314 

053600 

000000 

114576 1 

000000 

000020 

114602 

000000 

000000 

000000 

116064 

100400 

000000 1 

050100 

000040 

000370 

057410 

041354 

117074 

000105 

000000 

000000 1 

000000 

000060 

114642 

000000 

000000 

000000 

114652 

000000 

114656 i 

000000 


Figure 3-18 System Task Directory (Truncated) 
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3.2.9 Pool Dump 

As shown in Figure 3-19, CDA prints the system pool in octal, 
Radix-50, and ASCII. On RSX-11M-PLUS systems with secondary pool 
support, CDA prints a dump of secondary pool with the /SECPOL switch. 
If a line is repeated more than nine times, CDA prints it once and 
then prints a message indicating the number of identical lines. 

The symbols in Figure 3-19 have the following meanings: 

* Indicates that the next word is allocated. 

+ Indicates that the next word is contained in an unused, 

preallocated I/O packet (in $PKAVL free list). 


NOTE 

$PKAVL is a list containing fixed-size blocks. The 
blocks in this list are used for fast allocation, 
and I.LGTH determines the length of these blocks. 

Indicates that the next word is allocated in both $CRAVL and 
$PKAVL. (This is an error condition). 


NOTE 

$CRAVL is the free pool list head. 
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Figure 3-19 Pool Dump (Truncated) 
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Figure 3-19 (Cont.) 
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3.2.11 Clock Queue 

The example in Figure 3-21 shows a clock queue listing. The following 
list explains the example. 

Item Description 

1. Address of the clock queue entry 

2. Types of time schedule requests 
One of the following types: 

Type 0 - Mark time request 

Type 2 - Request with periodic rescheduling 
Type 4 - Single-shot task request 

Type 6 - Single-shot internal system subroutine with 
system subroutine identification 

Type 10- Single-shot internal system subroutine^ 
without system subroutine identification 

Type 12- Clear stop bit (Shuffler) 

3. Task Control Block address or system subroutine 
identification 

4. Task issuing the clock request 

5. The hour, minute, and second that time request comes due 

6. This field varies with each type of time schedule request 
For a Mark Time request, the labels are: 

C•AST - AST address 
C.SRC - Event flag mask word 
C.DST - Event flag mask address 
Event Flag Number 

For a periodic rescheduling request, the labels are: 

C.RSI - Reschedule internal 
C.UIC - Scheduling UIC 

The field for a single-shot task request contains only 
one label: 

C.UIC - Scheduling UIC 

The field for a single-shot internal subroutine (both 
with and without system subroutine identification) 
contains: 

C.SUB - Subroutine address 

C.AR5 - Relocation base address (for loadable 
drivers) 

7. Octal dump of clock queue in offset mode 
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R3X-UM CRASH DUMP ANALYZER 
CLOCK QUEUE 


ya.2 a-MAv-85 


15113 


PACE 116 


® ® ® ® 

ADDRESS « 054*210 REQUEST TYPE s 0 TCB * 10713a TASK s TKTN 

TIME REQUEST BECOMES DUE a 09|54|06.8® 

C t AST * 000000 C.SRC « 100000 C.DST a 107156 EVENT FLAG = 16.® 

000000 057250 010000 107134 01 1374 000000 000000 100000 107156^® 

ADDRESS = 057250 REQUEST TYPE « 0 TCB : 053510 TASK = PMT*., 

TIME REQUEST BECOMES DUE s 09|54i10.2 

C»AST = 124602 C.SRC = 000002 C.DST a 053532 EVENT FLAG s 2. 

000000 046760 001000 053510 011707 000000 124602 000002 053532 

ADDRESS 3 046760 REQUEST TYPE a 0 TCB a 053510 TASK = PMT... 

TIME REQUEST BECOMES DUE a 09|54i50,2 

C.AST = 000000 C.SRC = 000004 C.DST a 053532 EVENT FLAG a 3. 

000000 000000 001400 053510 016447 000000 000000 000004 053532 


Figure 3-21 Clock Queue 


3.2.12 Controller Information 

Figure 3-22 shows the information associated with a device controller. 
This information appears only in crash dumps of RSX-11M-PLUS systems. 
The following list explains the items in Figure 3-22. 

Item Description 

1. Name of the device controller 

2. Address of the Controller Table (CTB) 

3. Address of the Device Controller Block (DCB) for this 
device 

4. CTB status byte, which may contain any of the following 
three-letter status codes: 

CLK - Clock block appears at the top of the CTB 
MDC - Multidriver CTB 

CBL - Clock block is linked into the clock queue 
CIN - Controller uses the common interrupt dispatch 
table 

NET - DECnet device 

5. Octal dump of the CTB 

6. Common Interrupt Address 
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Item Description 

7. DCB for each device interfaced by this controller 

8. Name of each device interfaced by this controller 

9. Address of the Controller Request Block (KRB) 

10, Controller status. The following is a list of possible 

status values and their meanings: 

OFL - Controller is off line 

MOF - Controller is marked for off line 

UOP - Controller supports overlapped operations 

MBC - Device is a MASSBUS controller 

SDX - Seek operations allowed during data transfers 

POE - Parallel operations enabled 

UCB - UCB table present 

DIP - Data transfer in progress 

PDF - Privileged diagnostic functions only 

11. Octal dump of KRB in one or two parts 
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Figure 3-22 Controller Information 
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KRB ADDRESS ■ 022134 
K,STS I SOX WBC 
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Figure 3-22 (Cont.) Controller Information 


3.2.13 Kernel Data Space 

Figure 3-23 shows a dump of kernel data space from the specified 
starting virtual address to the specified ending virtual address. 


3.2.14 Kernel Instruction Space 

Figure 3-24 shows a dump of kernel instruction space from the 
specified starting virtual address to the specified ending virtual 
address. 


3.2.15 Task Data Space 

Figure 3-25 shows a dump of task data space. This dump occurs only on 
RSX-11M-PLUS systems. 


3.2.16 Task Instruction Space 

Figure 3-26 shows a dump of task instruction space. This dump occurs 
only on RSX-llM-PLUS systems. 
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CEND OF ANALYSIS OUTPUT] 


Figure 3-23 Kernel Data Space 
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CHAPTER 4 


INTERPRETING A CRASH DUMP LISTING 


This chapter introduces basic concepts that can help you to use CDA 
output listings to analyze the cause of a system crash. However, this 
chapter is not intended as a complete guide to interpreting a crash 
dump. 


4.1 HELPFUL CONCEPTS 

Two concepts are helpful in using CDA output listings to determine the 
cause of a system failure: 

• Determining what was mapped at the time of the crash 

• Interpreting stack depth and the kernel stack 


4.1.1 Determining What Was Mapped 

To determine what was mapped at the time of the crash, look at the 
dump of the Kernel Page Address Registers on the first page of the CDA 
listing (instruction space registers on RSX-11M systems, both 
instruction and data space registers on RSX-11M-PLUS systems). This 
listing, titled Volatile Registers, is shown in Figure 3-1. 

Figure 4-1 is an example of the listing of the contents of the sixth 
and seventh words from a Kernel Page Address Registers dump. The 
contents of the sixth and seventh words are the block numbers of the 
task or driver that was mapped at the time of the crash. You can 
determine what occupied that portion of memory from the memory map on 
the first page of partition information in the CDA output listing. 
Look under the BASE heading (for the base address of the mapped 
partition). 

You can use this information, along with data from the kernel stack 
and system common listings, to analyze the state of the system at the 
time of the crash. 
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Figure 4-1 Kernel Page Address Registers 


4.1.2 Interpreting the Kernel Stack 

$STKDP, which appears on the first page of the system common listing, 
is the system stack depth indicator. The value of the stack depth 
indicator shows which state the system was in when it crashed. The 
following lists shows the possible values of the stack depth indicator 
and the corresponding system states. 

$STKDP = 1 Indicates User state 

$STKDP = 0 Indicates System state 

$STKDP = -1,-2, -3, -4, ... Indicates Interrupt state 

Note that when the system is in Interrupt state, the stack depth value 
is negative. Two types of interrupt conditions can decrement stack 
depth: 

1. A synchronous system trap (SST), which can be caused by any 
of the following: 

• A directive 

• A TRAP instruction 

• An illegal instruction 

• Another SST 

2. The interrupt save routine ($INTSV) 

When an SST occurs, the following information from the current task is 
pushed onto the stack: 

The Processor Status Word (PSW) 

The Program Counter (PC) 

The address of return to DIRSV 
SST specific information 
R5 (Mapped systems only) 

R4 (Mapped systems only) 

R3 

R2 

Rl 

RO 
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When an interrupt occurs, the following are pushed onto the stack: 

PSW 

PC 

If a call to $INTSV is then issued, the following are pushed onto the 
stack after the PC: 

Address of return to $INTSV 

R5 

R4 

The stack depth is then decremented. If the value of $STKDP is 0 and 
the currently mapped driver issues a call to the $FORK routine, the 
following items are pushed onto the stack: 

Return to $FORK 

R3 (Which replaces the return to $INTSV) 

R2 

Rl 

RO 

If the driver issues a call to $FORK when $STKDP is not 0, the 
registers are saved in a fork block, which is queued for later 
execution. 

Since interrupts can still occur, more of both basic types of stack 
contents (interrupt or $INTSV) can be pushed. If an SST occurs in the 
Executive, SST information will be pushed onto the stack, possibly 
followed by a system crash. 

This information, along with the kernel stack pointer SP(K), which 
appears on the first page of the CDA listing, can be used to interpret 
the contents of the dump of the kernel stack. 

The contents of the PC and the PSW before the crash appear on the 
first page of the CDA listing. You can compare this information to 
the contents of the PC and the PSW on the stack to help locate the 
cause of the crash. 

Refer to the RSX-11M Guide to Writing an I/O Driver or to the 
RSX-llM-PLUS Guide to Writing an I/O Driver for a further description 
of the contents of the kernel stack. 
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CDA MESSAGES 


If you are a privileged user, you can install CDA and then 
reenter your command line. 


CDA — ACP out of memory or not in execution 
Type: Analysis diagnostic 

Explanation: The partition containing the File Control Block 
(FCB) for the current logical unit number (LUN) was not in 
memory. 


CDA — Address out of range 
Type: Fatal 

Explanation: CDA was unable to read a block from the crash-input 

file. Possible causes for this are: 

• A device failure 

• A bad block on the volume 

• The crashed system had a corrupted data base 

• The binary file does not contain all of the crashed system's 
memory 


CDA — Analysis output must be directed to an explicit device or file 
Type: Fatal 

Explanation: CDA requires an explicit output file specification. 

There are no default output file names. 


CDA — Analysis terminated after n. pages 
Type: Informational 

Explanation: CDA terminated the analysis after generating n 
pages of analysis output. If you have not specified the /LIMIT 
switch in the CDA command string, this message indicates that CDA 
has generated more than 300(decimal) pages of output. 


CDA — Command I/O error 
Type: Fatal 

Explanation: The system returned an error when CDA attempted to 

read a command line. 


CDA — Command line syntax error 
Type: Fatal 

Explanation: CDA detected an error in the syntax of a CDA 
command line. CDA will point to the beginning of the error 
within the command line. 
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CDA — Crash dump must be input from an explicit device or file 


Type: Fatal 

Explanation: The crash dump input file specification must be 
explicit. There is no default file specification for the crash 
dump input. 


CDA -- Device driver missing 
Type: Fatal 

Explanation: You have not loaded the driver for the crash dump 

input device. 


CDA -- Dump aborted - kernel PARS clobbered 
Type: Fatal 

Explanation: This message appears on mapped systems only. It 
indicates that the values contained in the kernel Page Address 
Registers are invalid. To restart the analysis, you must specify 
the /KMR switch. This switch forces CDA to use standard mapping 
values when converting kernel virtual addresses to physical 
memory addresses. 


CDA — Error reading crash dump 
Type: Fatal 

Explanation: The system returned an error when CDA attempted to 

read the crash dump file. This could be caused by: 

• A device failure 

• A bad block on the volume 

• On RSX-llM-PLUS systems, the device might not be mounted 
foreign 


CDA — Error reading file filename 
Type: Fatal 

Explanation: The system returned an error when CDA attempted to 

read the crash dump file. This could be caused by: 

• A device failure 

• A bad block on the volume 

CDA — Error reading symbol file filename 
Type: Fatal 


tf 
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Explanation: The system returned an error when CDA attempted to 

read the symbol table file indicated. Possible causes for the 
error are: 

• A device failure 

• A bad block on the volume 

• The specified symbol file was not an STB file 


CDA — Errors detected: n. 

Type : Inf o rma tiona1 

Explanation: CDA has detected n analysis errors during the run. 


CDA — Error writing analysis file 
Type: Fatal 

Explanation: The system returned an error when CDA attempted to 

write a line into the analysis listing file. This could be 
caused by: 

• A full volume 

• A problem with the device 

• A bad block on the volume 


CDA — Error writing dump file filename 
Type: Fatal 

Explanation: The system returned an error when CDA attempted to 

write into the binary output file. This condition could be 
caused by: 

• A full volume 

• A problem with the device 

• A bad block on the volume 


CDA — Exiting due to illegal trap - snapshot dump being attempted 
Type: Fatal 

Explanation: CDA has aborted after detecting an odd address or 
some other type of fault. If Postmortem Dump (PMD) is installed 
in the system, the system will generate a snapshot dump. This is 
an indication of a software problem. If you send a Software 
Performance Report (SPR) to DIGITAL for this type of failure, you 
should include any available dumps. 
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Also, preserve the following until your SPR is answered: 

1. From the crashed system: 

• All applicable user task images 

• RSXllM.SYS 

• RSXllM.STB 

• RSXMC•MAC 

• All applicable privileged task images 

• Crash dump volume 

2. From the system used for analysis: 

• RSXllM.SYS 

• RSXllM.STB 

• CDA.TSK 


CDA — Failed to assign LUN to input device ddu 
Type: Fatal 

Explanation: The Assign LUN (ALUN$) directive failed when CDA 
attempted to use it to attach the specified input device before 
reading the crash dump from the device. ALUN$ will fail if the 
device name in the CDA command line is invalid. 


CDA — Failed to extend page buffer - n. pages available 
Type : Informational 

Explanation: The Extend Task (EXTK$) directive failed when CDA 
attempted to use it to expand the page buffer. This problem will 
cause the analysis to take longer, but the analysis will continue 
with a buffer of n pages, each 256 words long. 


NOTE 

CDA uses the Extend Task directive to obtain 
additional buffering space. CDA does not use 
space allocated by a /INC= qualifier on the 
INStall command. 


CDA — Failed to open input file filename 
Type: Fatal 

Explanation: One of the following conditions exists: 

• The specified device does not exist. 

• The volume is not mounted. 

• A problem exists with the device. 


A-5 








CDA MESSAGES 


• The specified UFD does not exist. 

• The specified file does not exist. 

• You do not have read access privileges. 

CDA — Failed to open output file filename 
Type: Fatal 

Explanation: One of the following conditions exists: 

• The specified device does not exist. 

• The volume is not mounted. 

• A problem exists with the device. 

• The specified UFD does not exist. 

• The volume is full or the device is write-protected. 

• You do not have write access privilege to UFD. 


CDA -- Illegal switch 
Type: Fatal 

Explanation: You specified an unknown switch or used a legal 
switch with the wrong file specification. CDA will point to the 
error within the command line. 


CDA -- Inconsistency in dynamic storage 
Type: Informational 

Explanation: CDA detected an inconsistency while scanning the 
pool pointers. This condition could be associated with the 
crash. However, it may mean that you specified the wrong 
executive symbol table file. 


CDA — Indirect command syntax error 
Type: Fatal 

Explanation: The name of the indirect command file (@filename) 

is syntactically incorrect. 


CDA — Indirect file open failure 
Type: Fatal 

Explanation: CDA could not open an indirect command file 

specified as '^filename" in the CDA command line. 
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CDA — Invalid address range 
Types Fatal 


Explanation: You specified an address that was not 

with Active Page Register (APR) mapping. 


consistent 


CDA — List count expired 

Type: Analysis diagnostic 


Explanation: The linked list of data structures has too many 

entries. The list may be corrupted, or contains a loop. 

CDA — Maximum indirect file depth exceeded 
Type: Fatal 

Explanation: You exceeded the maximum allowable number of nested 

indirect command files. (CDA only permits one indirect command 
level.) 


CDA — No input file specified 
Type: Fatal 

Explanation: You did not specify a crash dump input file. 

CDA — No output file specified 
Type: Fatal 

Explanation: You did not specify an output file. 

CDA — Output dump filename must be explicit 
Type: Fatal 

Explanation: You did not specify a valid output file. 


CDA — Pool link error found - continuing 
Type: Analysis diagnostic 

Explanation: CDA detected a link error while scanning the pool 
free block pointers ($CRAVL). This condition can be associated 
with the crash. It can also mean that you specified the wrong 
Executive symbol table file. If the latter is true, the entire 
analysis will be meaningless and you should abort CDA. 


CDA — Premature end of dump input - filename being zero-filled 
Type: Informational 

Explanation: CDA reached the end of the medium (or the 
end-of-file mark on a magnetic tape) before the crash dump output 
file had been completely filled. If you expected the file to be 
completely filled by the dump, this condition could indicate a 
problem. 


A-7 







CDA MESSAGES 


CDA — Processor n failed to dump its registers 
Type: Informational 

Explanation: On a multiprocessor system, when the system 
crashes, each on-line processor is notified by an interrupt. If 
the processor does not respond to the interrupt (for example, if 
it halted or is off line), it won’t dump its registers into the 
crash buffer. CDA notes this and prints the informational 
message. 


CDA — Redirect error (U.RED=0) 

Type: Analysis diagnostic 

Explanation: CDA detected an error in the pointer to the Unit 

Control Block (UCB) of a redirected unit. This condition may be 
associated with the cause of the crash. 


CDA — Symbol symbolname not defined in symbol file 
Type: Fatal 

Explanation: CDA did not find a symbol that it required for the 
analysis in the specified Executive symbol table file. You have 
probably entered the wrong file name or have mistakenly used the 
default file name. 


CDA — Symbol file filename has illegal format 
Type: Fatal 

Explanation: The specified Executive symbol table file has an 
improper format, probably caused by entry of the wrong file name. 
However, this message could also indicate a problem with the 
device or medium on which the file is located. 


CDA — Task 'taskname' not in memory 
Type: Analysis diagnostic 

Explanation: This message can be caused by two conditions: 

1. You have requested a dump of a task which does not have an 
entry in the System Task Directory 

2. The task has an entry in the System Task Directory, but it is 
marked out of memory. 

You can verify the state of the task by examining a dump of the 
Task Control Blocks. 


CDA — Transfer complete - ddu may be unloaded 
Type: Informational 

Explanation: The transfer of the crash dump to the output file 
is finished; you may unload the crash dump device. This message 
occurs only when you have specified a binary file in the output 
of the command string to CDA. 
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CDA — Unknown AST type 

Type: Analysis diagnostic 

Explanation: CDA has detected an AST block which 

the following valid types of ASTs: 

• Unsolicited character AST 

• Buffered I/O AST 

• Emit status AST 


is not 


one of 


• Completion AST from: 

QIO$ 

MRKT$ 

SPWN$ 

CNCT$ 

CINT$ 

1. Specified AST from: 

SFPA$ 

SRDA$ 

SRRA$ 

SPFA$ 


CDA — Unknown get command line error 
Type: Fatal 

Explanation: An unrecognized error occurred when CDA attempted 

to read a command line. 


CDA — $PKVAL link error at n —FWD PTR = n 


Type: Analysis diagnostic 


Explanation: CDA detected a link error while scannin 
free packet list $PKVAL. This condition can be ass 
the crash. It can also mean that you specified 
executive symbol table file. 


g the pool 
ociated with 
the wrong 
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APPENDIX B 


RSX-11M SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS 


This appendix describes the RSX-11M system macros that supply symbolic 
offsets for data structures listed in Table B-l. 

The data structures are defined by macros in the Executive macro 
library. To reference any of the data structure offsets from your 
code, include the macro name in an .MCALL directive and invoke the 
macro. For example: 

.MCALL DCBDF$ 

DCBDF$ ;Define DCB offsets 


NOTE 


All physical offsets and bit definitions are subject 
to change in future releases of the operating system. 
Code that accesses system data structures should 
always use the symbolic offsets rather than the 
physical offsets. 


The first two arguments, <:> and <=>, make all definitions global. If 
they are left blank, the definitions will be local. 

All of these macros are in the Executive macro library 
LB: [ 1,1]EXEMC.MLB. All except ITBDF$ and MTADF$ are also in the 
Executive definition library LB:[1,1]EXELIB.OLB. 


Table B-l 

Summary of System Data Structure Macros 


Macro 


Arguments 


Data Structures 


ABODF$ <:>,<=> 


Task abort and termination 
notification message codes 


CLKDF$ <:>,<=> 


Clock queue control block 


DCBDF$ <:>,<=> 


Device Control Block 


EPKDF$ <:>,<=> 


Error message block 


EVNDF$ <:>,<=> 


Terminal Software Architecture 
(TSA) event packet definitions 


(Continued on next page) 
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RSX-11M SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS 


Table B-l (Cont.) 

Summary of System Data Structure Macros 


Macro Arguments 


Data Structures 


F11DF$ <:>,<=> Files-11 data structures (volume 

control block, mount list entry, 
file Control Block, file window 
block, locked block list node) 


HDRDF$ 

A 

• • 

V 

A 

II 

V 

Task header and window block 

HWDDF$ 

A 

II 

V 

v 

A 

V 

Hardware register addresses and 
feature mask definitions 

ITBDF$ 

A 

II 

V 

A 

V 

Interrupt transfer block 

LCBDF$ 

A 

V 

A 

II 

V 

Logical assignment control block 

MTADF$ 

A 

II 

V 

A 

V 

ANSI magtape data strucures 

(volume set control block) 

PCBDF$ 

A 

V 

A 

II 

V 

Partition Control Block and 

attachment descriptor 

PKTDF$ 

A 

V 

A 

II 

V 

I/O packet, AST control block, 
offspring control block, group 
global event flag control block, 
and CLI parser block 

SCBDF$ 

A 

• • 

V 

A 

II 

V 

Status Control Block and UMR 

assignment block 

TCBDF$ 

A 

V 

A 

II 

V 

Task Control Block 

UCBDF$ 

<:>,<=>,TTDEF 

Unit Control Block 











RSX-11M SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS 


ABODF$ 


.MACRO ABODF$,L,B 

TASK ABORT CODES 

NOTE: S.COAD-S.CFLT ARE ALSO SST VECTOR OFFSETS 


S.CACT = 
S.CEXT = 
S • COAD : 
S.CSGF = 
S • CBPT : 
S.CIOT = 
S.CILI : 
S .CEMT : 
S • CTRP : 
S • CFLT : 
S • CSST : 
S. CAST : 
S • CABO : 
S • CLRF : 
S .CCRF : 
S . IOMG : 
S.PRTY 
S.CPMD 
S .CINS : 


■ * B * — 4 • 
: , B , -2. 
: * B 1 0 . 

: *B 1 2. 

: *B 1 4 . 

: *B 1 6. 

: * B 1 8 . 

: *B 1 10. 
: 1 B * 12 • 
: 1 B 1 1 4 • 
:'B'i6. 
: *B 1 18 « 
: *B 1 20. 
: , B , 22. 
= , B , 24. 

= 1 B 1 2 8 . 

: 1 B 1 32. 


TASK STILL ACTIVE 
TASK EXITTED NORMALLY 
ODD ADDRESS AND TRAPS TO 4 
SEGMENT FAULT 
BREAK POINT OR TRACE TRAP 
IOT INSTRUCTION 
ILLEGAL OR RESERVED INSTRUCTION 
NON RSX EMT INSTRUCTION 
TRAP INSTRUCTION 
11/40 FLOATING POINT EXCEPTION 
SST ABORT-BAD STACK 
AST ABORT-BAD STACK 
ABORT VIA DIRECTIVE 
TASK LOAD REQUEST FAILURE 
TASK CHECKPOINT READ FAILURE 
TASK EXIT WITH OUTSTANDING I/O 
TASK MEMORY PARITY ERROR 
TASK ABORTED WITH PMD REQUEST 
TASK INSTALLED IN TWO SYSTEMS 


TASK TERMINATION NOTIFICATION MESSAGE CODES 


T.NDNR='B'0 


;DEVICE NOT READY 

.NDSE='B'2 


;DEVICE SELECT ERROR 

T.NCWF='B'4 


CHECKPOINT WRITE FAILURE 

T.NCRE='B'6 


;CARD READER HARDWARE ERROR 

T.NDMO='B'8. 


;DISMOUNT COMPLETE 

T.NUER='B'10. 


;UNRECOVERABLE ERROR 

T.NLDN='B'12. 


;LINK DOWN (NETWORKS) 

T.NLUP='B'14. 


;LINK UP (NETWORKS) 

T.NCFI='B'16. 


CHECKPOINT FILE INACTIVE 

T.NUDE='B'18. 


;UNRECOVERABLE DEVICE ERROR 

T.NMPE='B'20. 


;MEMORY PARITY ERROR 

T.NKLF='B'22. 


;UCODE LOADER NOT INSTALLED 

T.NDEB='B'24. 


;TASK HAS NO DEBUGGING AID 

T.NRCT='B'26. 


CONTROL TASK NOT INSTALLED 

T.NWBL='B'28. 


;WRITE BACK CACHING DATA LOST. UN! 



;WRITE LOCKED 

T.NPNT='B 1 30. 


;REQUIRED PARTITION NOT IN SYSTEM 

T.NIOS='B'32. 


;I/O STALLED 

T.NIOR='B'34. 


;I/O RESUMING 

.MACRO 

ABODF$ 

X,Y 

. ENDM 



. ENDM 
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RSX-11M SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS 


CLKDF$ 


.MACRO CLKDF$,L,B 


CLOCK QUEUE CONTROL BLOCK OFFSET DEFINITIONS 
CLOCK QUEUE CONTROL BLOCK 

THERE ARE SIX TYPES OF CLOCK QUEUE CONTROL BLOCKS. EACH CONTROL 
BLOCK HAS THE SAME FORMAT IN THE FIRST FIVE WORDS AND DIFFERS 
IN THE REMAINING THREE. 

THE FOLLOWING CONTROL BLOCK TYPES ARE DEFINED: 


C.MRKT='B'0 

C.SCHD='B'2 

C.SSHT='B'4 

C.SYST='B'6 

C.SYTK='B'8. 

C.CSTP='B'10. 


;MARK TIME REQUEST 

;TASK REQUEST WITH PERIODIC RESCHEDULING 
;SINGLE SHOT TASK REQUEST 
;SINGLE SHOT INTERNAL SYSTEM SUBROUTINE 
; (IDENT) 

;SINGLE SHOT INTERNAL SYSTEM SUBROUTINE 
;(TASK) 

;CLEAR STOP BIT (CONDITIONALI ZED ON 
;SHUFFLING) 


CLOCK QUEUE CONTROL BLOCK TYPE INDEPENDENT OFFSET DEFINTIONS 


.ASECT 


.=0 

C.LNK: 

'L' 

• BLKW 

1 

;CLOCK QUEUE THREAD WORD 

C.RQT: 

*L* 

• BLKB 

1 

;REQUEST TYPE 

C.EFN: 

'L' 

• BLKB 

1 

;EVENT FLAG NUMBER (MARK TIME ONLY) 

C.TCB: 

1 L 1 

• BLKW 

1 

;TCB ADDRESS OR SYSTEM SUBROUTINE 

C.TIM: 

1 L 1 

• BLKW 

2 

;IDENTIFICATION 

;ABSOLUTE TIME WHEN REQUEST COMES DUE 


CLOCK QUEUE CONTROL BLOCK-MARK TIME DEPENDENT OFFSET DEFINITIONS 


.=C.TIM+4 
C.AST:'L' 
C.SRC:'L' 
C.DST:'L' 


.BLKW 1 
•BLKW 1 
.BLKW 1 


;START OF DEPENDENT AREA 
;AST ADDRESS 

;FLAG MASK WORD FOR 'BIS' SOURCE 
;ADDRESS OF 'BIS' DESTINATION 


CLOCK QUEUE CONTROL BLOCK-PERIODIC RESCHEDULING DEPENDENT OFFSET 
DEFINITIONS 


.=C.TIM+4 

C.RSI:'L' .BLKW 2 

C.UIC:'L' .BLKW 1 


;START OF DEPENDENT AREA 
;RESCHEDULE INTERVAL IN CLOCK TICKS 
;SCHEDULING UIC 
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RSX-11M SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS 


CLKDF$ (Cont.) 


CLOCK QUEUE CONTROL BLOCK-SINGLE SHOT DEPENDENT OFFSET DEFINITIONS 


. =C.TIM+4 ;START OF DEPENDENT AREA 

.BLKW 2 ;TWO UNUSED WORDS 

.BLKW 1 ;SCHEDULING UIC 


CLOCK QUEUE CONTROL BLOCK-SINGLE SHOT INTERNAL SUBROUTINE OFFSET 
DEFINITIONS 

THERE ARE TWO TYPE CODES FOR THIS TYPE OF REQUEST: 'L' 

TYPE 6=SINGLE SHOT INTERNAL SUBROUTINE WITH A 16-BIT VALUE AS 
AN IDENTIFIER. 

TYPE 8=SINGLE SHOT INTERNAL SUBROUTINE WITH A TCB ADDRESS AS 
AN IDENTIFIER. 


.=C.TIM+4 


;START OF DEPENDENT AREA 


C.SUB:'L' 

.BLKW 1 

;SUBROUTINE ADDRESS 


C.AR5:'L' 

.BLKW 1 

;RELOCATION BASE (FOR LOADABLE 

DRIVERS) 


.BLKW 1 

;ONE UNUSED WORD 


C.LGTH='B' 

1 

;LENGTH OF CLOCK QUEUE CONTROL 

BLOCK 


.PSECT 




.MACRO 

CLKDF$ X,Y 



. ENDM 




. ENDM 













RSX-11M SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS 


DCBDFS 


DCBDF 


MACRO 


DCBDF$ 


DEVICE CONTROL BLOCK 

THE DEVICE CONTROL BLOCK (DCB) DEFINES GENERIC 
INFORMATION ABOUT A DEVICE TYPE AND THE LOWEST AND 
HIGHEST UNIT NUMBERS. THERE IS AT LEAST ONE DCB FOR 
EACH DEVICE TYPE IN A SYSTEM. FOR EXAMPLE, IF THERE 
ARE TELETYPES IN A SYSTEM, THEN THERE IS AT LEAST ONE 
DCB WITH THE DEVICE NAME ’TT'. IF PART OF THE 
TELETYPES WERE INTERFACED VIA DLll-A'S AND THE REST 
VIA A DH11, THEN THERE WOULD BE TWO DCB'S. ONE FOR 
ALL DL11-A INTERFACED TELETYPES, AND ONE FOR ALL DH11 
INTERFACED TELETYPES. 


.ASECT 


.=0 


000000 

D.LNK: 

. BLKW 

000002 

D.UCB: 

• BLKW 

000004 

D.NAM: 

.BLKW 

000006 

D.UNIT: 

• BLKB 

000007 


• BLKB 

000010 

D.UCBL: 

.BLKW 

000012 

D.DSP: 

.BLKW 

000014 

D.MSK: 

.BLKW 

000016 


.BLKW 

000020 


.BLKW 

000022 


.BLKW 

000024 


.BLKW 

000026 


.BLKW 

000030 


.BLKW 

000032 


.BLKW 

000034 

D.PCB: 

.BLKW 



.PSECT 


1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 


LINK TO NEXT DCB 

POINTER TO FIRST UNIT CONTROL BLOCK 
GENERIC DEVICE NAME 

LOWEST UNIT NUMBER COVERED BY THIS DCB 
HIGHEST UNIT NUMBER COVERED BY THIS DCB 
LENGTH OF UNIT CONTROL BLOCK IN BYTES 
POINTER TO DRIVER DISPATCH TABLE 
LEGAL FUNCTION MASK CODES 0-15. 

CONTROL FUNCTION MASK CODES 0-15. 

NOP'ED FUNCTION MASK CODES 0-15. 

ACP FUNCTION MASK CODES 0-15. 

LEGAL FUNCTION MASK CODES 16.-31. 
CONTROL FUNCTION MASK CODES 16.-31. 

NOP'ED FUNCTION MASK CODES 16.-31. 

ACP FUNCTION MASK CODES 16.-31. 

LOADABLE DRIVER PCB ADDRESS 


DRIVER DISPATCH TABLE OFFSET DEFINITIONS 


D.VDEB=177776 
D.VINI=0 
D.VCAN=2 
D.VOUT=4 
D.VPWF=6 


REALLOCATE INTERNAL BUFFERS (FD TTDRV) 
;DEVICE INITIATOR 
;CANCEL CURRENT I/O FUNCTION 
;DEVICE TIMEOUT 
;POWERFAIL RECOVERY 
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RSX-11M SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS 


.MACRO EPKDF $,L,B 

h 

Error Message Block Definitions 
.ASECT 


EPKDFS 


Header Subpacket 


| Subpacket Length in Bytes 


- + 

l 

- + 

I Subpacket Flags 

I-+-+ 

I Format Identification I Operating System Code | 

|----+ 

Operating System Identification 


| Flags 


-+- 

I 

-+- 


Context Code 


| Entry Sequence 


1 Error Sequence 

| Entry Type Subcode 

Entry Type Code 

Time Stamp 



I Reserved | Processor Type 

i-- -y +- 

| Processor Identification (URM) 

-- 


-+ 

I 

-+ 


o 

ii 

• 



E$HLGH:'L' 

.BLKW 

1 

E$HSBF:'L' 

. BLKW 

1 

E$HSYS:'L' 

.BLKB 

1 

E$HIDN:'L' 

. BLKB 

1 

E$HSID:'L' 

.BLKB 

4 

E$HCTX:'L' 

.BLKB 

1 

E$HFLG:'L' 

.BLKB 

1 

E$HENS:'L' 

.BLKW 

1 

E$HERS:'L' 

.BLKW 

1 

E$HENC:'L' 



E$HTYC:'L' 

.BLKB 

1 

E$HTYS:'L' 

.BLKB 

1 

E$HTIM:'L' 

.BLKB 

6 

E$HPTY:'L' 

.BLKB 

1 


.BLKB 

1 

E$HURM:'L' 

.BLKW 

1 


.EVEN 


E$HLEN:'L' 




Subpacket length in bytes 
Subpacket Flags 
Operating System Code 
Format Identification 
Operating System Identification 
Context Code 
Flags 

Entry Sequence Number 
Error Sequence Number 
Entry Code 
Entry Type Code 
Entry Type Subcode 
Time Stamp 
Processor Type 
Reserved 
Processor Identification (URM) 


; Length 
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EPKDF$ (Cont.) 


Subpacket Flags 

for E$HSBF 

SM.ERR='B' 

1 

SM.HDR='B' 

1 

SM.TSK='B 1 

2 

SM.DID='B' 

4 

SM.DOP='B' 

10 

SM.DAC='B' 

20 

SM.DAT='B' 

40 

SM.MBC='B' 

20000 

SM.CMD='B' 

40000 

SM.ZER='B' 

100000 

Codes for field 

E$HIDN 


EH$FOR='B' 1 


Error Packet 
Header Subpacket 
Task Subpacket 

Device Identification Subpacket 
Device Operation Subpacket 
Device Activity Subpacket 
Data Subpacket 

22-bit massbus controller present 
Error Log Command Packet 
Zero I/O Counts 


Current packet format 


Flags for the error 


log flags byte ($ERFLA) in the exec. 


ES.INI='B' 1 
ES.DAT='B' 2 
ES.LIM='B' 4 
ES.LOG='B' 10 


; Error log initialized 
; Error log receiving data packets 
; Error limiting enabled 
; Error logging enabled 


Type and Subtype Codes for fields E$HTYC and E$HTYS 

Symbols with names E$Cxxx are type codes for field E$HTYC, 
symbols with names E$Sxxx are subtype codes for field E$HTYS 


E$CCMD='B' 1 
E$SSTA='B' 1 
E$SSWI='B' 2 
E$SAPP='B' 3 
E$SBAC='B' 4 
E$SSHO='B' 5 
E$SCHL='B ' 6 
E$CERR='B' 2 
E$SDVH= 1 B' 1 
E$SDVS= 1 B' 2 
E$STMO='B ' 3 
E$SUNS='B' 4 
E$STMS='B ' 5 
E$CDVI='B' 3 
E$SDVI='B' 1 


Error Log Control 

Error Log Status Change 
Switch Logging Files 
Append File 
Declare Backup File 
Show 

Change Limits 
Device Errors 

Device Hard Error 
Device Soft Error 
Device Interrupt Timeout (HARD) 
Device Unsolicited Interrupt 
Device Interrupt Timeout (SOFT) 
Device Information 

Device Information Message 


E$CDCI='B' 4 
E$SMOU='B ' 1 
E$SDMO='B' 2 
E$SRES='B ' 3 
E$SRCT='B ' 4 
E$CMEM='B ' 5 
E$SMEM='B' 1 
E$CSYS='B' 6 
E$SPWR='B' 1 


Device Control Information 
Device Mount 
Device Dismount 
Device Count Reset 
Block Replacement 
Memory Detected Errors 
Memory Error 

System Control Information 
Power Recovery 
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EPKDFS (Cont.) 


E$CCTL='B' 

7 

; Control Information 

E$STIM='B' 

1 

; Time Change 

E$SCRS='B' 

2 

; System Crash 

E$SLOA='B ' 

3 

; Device Driver Load 

E$SUNL='B 1 

4 

; Device Driver Unload 

E$SHRC='B' 

5 

; Reconfiguration Status 

E$SMES='B' 

6 

; Message 

E$CCPU='B 1 

10 

; CPU Detected Errors 

E$SINT='B' 

1 

; Unexpected Interrupt 

E$CSDE= 1 B 1 

11 

; Software Detected Events 

E$SABO='B' 

1 

; Task Abort 

for Context Code 

entry E$HCTX 

EH$NOR='B' 

1 

; Normal Entry 

EH$STA= 1 B 1 

2 

; Start Entry 

EH$CRS='B' 

3 

; Crash Entry 


Codes for Flags entry E$HFLG 


EH$VIR=*B 1 
EH$EXT= 1 B 1 
EH$COU=*B 1 
EH$QBS='B 1 
EH$LMR= 1 B 1 


1 

2 

4 

10 

20 


Addresses are virtual 
Addresses are extended 
Error counts supplied 
Q-BUS CPU 
Limit reached 


Task Subpacket 

+ - . - + 

| Task Subpacket Length j 

I Task Name in RAD50 j 

--+ 

I Task UIC 

--+ 

| Task TI: Device Name 

+-+-+ 

| Flags | Task TI: Unit Number 

+ - + - + 


.=0 


E$TLGH:'L' 

. BLKW 

1 

Task Subpacket Length 

E$TTSK:'L' 

. BLKW 

2 

Task Name in RAD50 

E$TUIC:'L' 

.BLKW 

1 

Task UIC 

E$TTID:'L' 

. BLKB 

2 

Task TI: Device Name 

E$TTIU:'L' 

• BLKB 

1 

Task TI: Unit 

E$TFLG:'L' 

.BLKB 

1 

Flags 


.EVEN 



E?$TLEN: 'L' 





Flags for entry E$TFLG 

ET$PRV= 1 B' 1 
ET$PRI= 1 B 1 2 


Task is Privileged 
Terminal is Privileged 
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RSX-11M SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS 


EPKDFS (Cont.) 


Device Identification Subpacket 


Device Identification 

Subpacket Length 

Device Mnemonic Name 

Controller Number 


Device Unit Number 

Physical Subunit # 

l 

Physical Unit # 

Physical Device Mnemonic 

(RSX-11M-PLUS only) 

Reserved 

l 

Flags 


Volume Name of Mounted Volume 


+ - 


Pack Identification 
Device Type Class 


-+ 


Device Type 


I/O Operation Count Longword 


| Hard Error Count 

+ - + 

Blocks Transferred Count (RSX-11M-PLUS only) 


+ - + 

| Soft Error Count 


+-+ 

Cylinders Crossed Count (RSX-11M-PLUS only) 


.=0 


E$ILGH:'L' 

.BLKW 1 

} 

Device Identification Subpacket Length 

E$ILDV:'L' 

.BLKW 1 

} 

Device Mnemonic Name 

E$ILUN:'L' 

.BLKB 1 

r 

Device Unit Number 

E$IPCO:'L' 

.BLKB 1 

} 

Controller Number 

E$IPUN:'L' 

•BLKB 1 

} 

Physical Unit Number 

E$IPSU: 'L' 

.BLKB 1 

} 

Physical Subunit Number 


.IF DF 

R$$MPL 

E$IPDV:'L' 

.BLKW 1 

r 

Physical Device Mnemonic 


.ENDC ; R$$MPL 
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EPKDF$ (Cont.) 


E$IFLG:'L' 

. BLKB 

1 


Flags 


• BLKB 

1 


Reserved 

E$IVOL:'L' 

.BLKB 12. 


Volume Name 

E$IPAK:'L' 

.BLKB 

4 


Pack Identification 

E$IDEV:'L' 




Device Type 

E$IDCL:'L' 

.BLKW 

1 


Device Type Class 

E$IDTY:'L' 

. BLKW 

2 


Device Type 

E$IOPR:'L' 

.BLKW 

2 


I/O Operation Count Longword 

E$IERS:'L' 

.BLKB 

1 


Soft Error Count 

E$IERH:'L' 

.BLKB 

1 


Hard Error Count 


. IF 

DF 

R$$MPL 

E$IBLK:'L' 

.BLKW 

2 

i 

} Blocks transferred count 

E$ICYL:'L' 

.BLKW 

2 

i 

; Cylinders crossed count 


.ENDC ; 

R$$MPL 


.EVEN 




E$ILEN:'L' 




; Subpacket Length 

/ 

; Flags for 

field 

E$IFLG 


EI $SUB='B 1 

1 


; Subcontroller device 


.IF 

DF 

R$$MPL 

EI$NUX='B' 

2 


; No UCB extension, data inva 


.ENDC ? R$$MPL 


Device Operation Subpacket 
+- 

+ 


Device Operation Subpacket Length 
Task Name in RAD50 


- + 

I 

-+ 


| Task UIC 


I Task TIs Logical Device Mnemonic 

| - + - + 

| Reserved | Task TI: Device Unit 

+-+-+ 

I I/O Function Code 

I-+-+ 

I Reserved | Operation Flags 

+-+-+ 

Transfer Operation Address 


| Transfer Operation Byte Count 


| Current Operation Retry Count 


-+ 

l 

-+ 

I 

-+ 


.=0 
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EPKDF$ (Cont.) 


E$OLGN: 1 L' .BLKW 

1 

; Subpacket Length 

E$OTSK:'L' .BLKW 

2 

; Task Name in RAD50 

E$OUIC:'L' .BLKW 

1 

; Task UIC 

E$OTID:'L' .BLKB 

2 

; Task TI: Logical Device Mnemonic 

E$OTIU:'L' .BLKB 

1 

; Task TI: Logical Device Unit 

• BLKB 

1 

; Reserved 

E$OFNC:'L' .BLKW 

1 

; I/O Function Code 

E$OFLG:'L' .BLKB 

1 

; Operation Flags 

.BLKB 

1 

; Reserved 

E$OADD:'L' .BLKW 

2 

; Transfer Operation Address 

E$OSIZ:'L' .BLKW 

1 

; Transfer Operation Byte Count 

E$ORTY:'L' .BLKW 
.EVEN 

1 

; Current Operation Retry Count 

E$OLEN:'L' 


; Device Operation Subpacket Length 

; Flags for field E$OFLG 


EO$TRA='B' 

1 

; Transfer Operation 

EO$DMA='B 1 

2 

; DMA Device 

EO$EXT='B' 

4 

; Extended Addressing Device 

EO$PIP='B' 

10 

; Device is positioning 

; I/O Activity Subpacket 



+ -- 

I/O Activity Subpacket Length 

--- 


.=0 

E$ALGH: 1 L 1 .BLKW 1 ; Subpacket Length 


I/O Activity Subpacket Entry 


Logical Device Name Mnemonic 

Controller Number 

Logical Device Unit 

Physical Subunit # 

Physical Unit Number 

Physical Device Mnemonic 

: (RSX-11M-PLUS only) 

Task TI: logical unit | 

Device flags 

Requesting Task Name in 

RAD 50 

Requesting Task UIC 

Task TI: Logical Device 

Name 

I/O Function Code 



(Continued on next page) 
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EPKDF$ (Cont.) 


+ - + - + 

| Reserved | Flags 

+ - + - + 

Transfer Operation Address 

+-+ 

| Transfer Operation Byte Count 
+-+ 


.=0 


E$ALDV:'L' 

.BLKW 

1 

; Logical Device Name Mnemonic 

E$ALUN:'L' 

. BLKB 

1 

; Logical Device Unit 

E$APCO:'L' 

• BLKB 

1 

; Controller Number 

E $APUN: 'L' 

.BLKB 

1 

; Physical Unit Number 

E$APSU:’L' 

.BLKB 

1 

; Physical Subunit Number 


.IF DF 

R$$MPL 

E$APDV:'L' 

.BLKW 

.ENDC 

1 

; Physical Device Mnemonic 

E$ADFG:'L' 

.BLKB 

1 

; Device flags 

E$ATIU:'L' 

.BLKB 

1 

; Task TI: Logical Unit 

E$ATSK:'L' 

.BLKW 

2 

; Requesting Task Name in RAD50 

E$AUIC:'L' 

.BLKW 

1 

; Requesting Task UIC 

E$ATID:'L' 

.BLKW 

1 

; Task TI: Logical Device Name 

E$AFNC:'L' 

.BLKW 

1 

; I/O Function Code 

E$AFLG:'L' 

.BLKB 

1 

; Flags 


.BLKB 

1 

; Reserved 

E$AADD:'L' 

.BLKW 

2 

; Transfer Operation Address 

E$ASIZ:'L' 

E$ALEN:'L' 

.BLKW 

.EVEN 

1 

; Transfer Operation Byte Count 

; Subpacket Entry Length 


Flags for field E$ADFG 

EA$SLJB= *B * 1 ; Subcontroller device 


.IF DF R$$MPL 

EA$NUX='B 1 2 ; No UCB extension, data invalid 


.ENDC ; R$$MPL 


Flags for field E$AFLG 


EA$TRA= 1 B* 1 

EA$DMA= 1 B 1 2 

EA$EXT='B 1 4 

EA$PIP= 1 B 1 10 


; Transfer Operation 
; DMA Device 

; Device has Extended Addressing 
; Device is positioning 


.PSECT 

.MACRO EPKDF$ X,Y 
. ENDM 


. ENDM 
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EVNDF$ 


.MACRO EVNDF$,L,B,LST 


EVNDF$ — Event Packet Definitions 

This module contains a macro which defines the offsets and field 
values for TSA Event Packets (TEP's). These packets are used to 
pass data and status information between system components that 
provide Digital's Terminal Software Architecture support on RSX. 


Explicit Inputs: 

L 

B 

LST 

Implicit Inputs: 
NONE 

Outputs: 


for global offset definitions 
"=" for global bit/value definitions 
"LIST" for macro expansion listing 



Symbols defined as described above. 
Listing as described above. 


General packet header format 

.ASECT 

.=0 


E.VLNK:'L' 
E.VSIZ:'L' 
E.VTYP:'L' 
E.VUCB:'L' 


Define offsets absolutely 


.BLKW 1 ; Link word 

•BLKB 1 ; Packet size 

.BLKB 1 ; Packet type 

.BLKW 1 ; Terminal UCB address 


; E.VTYP Values 

} 

ET.LOW='B'0 

ET.QIO='B'0 
ET.BND='B'2 
ET•UNB='B'4 
ET.BCP='B'6 
ET.REJ='B'10 
ET.DIS='B'12 
ET.DCP='B'14 
ET.ICS='B'16 
ET.OOB='B'20 
ET.ONO='B'22 
ET.PHO='B'24 

ET.HI='B'24 


Lowest valid type code 

QIO(distinguishes QIO packet from TEP) 

Bind Request 

Unbind Request 

Bind Complete 

Bind Reject 

Disconnect Notification 
Disconnect Complete 
Input Count State Change 
Out-of-Band (OOB) 

Abnormal Termination Request 
Physical Terminal Disconnected 


Highest valid type code 
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EVNDF$ (Cont.) 


The following definitions are for packet types that require 
passing additional information in the packets. All other packet 
types use the general packet format described above. 


Bind Request packet 
.=E.VUCB+2 


E.VBCT:'L' 
E.VBND:'L' 
E.VBLN:'L' 


(Terminal Management Mode --> Network) 


.BLKW 1 ; Count of nodes (One for now) 
.BLKB 6 ? Node name 

; Length of bind request 


Input Count State Change, Out-Of-Band packets (TTDRV —> Network) 
And Modem Hang-up packets (TSA... —> Network) 

,=E.VUCB+2 


E.VAPR:'L* 
E.VADR:'L' 
E.VFLG:'L' 


.BLKW 1 ? 
.BLKW 1 ; 
.BLKW 1 ; 


Doubleword address of 
...queueing routine 
Flag 


packet... 


? Input Count State Change 
.=E.VFLG+2 

E.VSLNr'L* ; Length of Input state message 

? 

; 00B 

.=E.VFLG+2 


E.VOBM: 1 L * 
E.VHDR:'L' 
E.VTAB: 1 L 1 
E.VOLN:'L' 


.BLKW 6 ; Out-of-Band bitmasks 
.BLKW 2 ; Type-ahead buffer header 
.BLKB 10. ; Type-ahead buffer 
; Length of OOB packet 


Terminal Management Switch Characters 


.=E.VFLG+2 


E.VSWCi'L* .BLKW 1 ; Terminal management switch characters 

E.VTLN:'L 1 ; Length of Switch Character packet 


Bit values in flag word (E.VFLG). For convenience some bits have 

corresponding bits in the AST Control Block flag word (A.PRM+5). 


EF.NCO='B'1 
EF•NOI='B'2 
EF.AST= *B'10 
EF.LCK='B'4 0 
EF.QUE='B'100 
EF.MDE= 'B 1 200 


All non-control characters are out-of band 

All non-control OOB are include-OOB 

Reserved bit synonymous with TF.AST 

Reserved bit synonymous with AF.LCK 

TEP is queued 

TEP is marked for delete 
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EVNDF$ (Cont.) 


Unbind Request packet (TMM --> Network) 
.=E.VUCB+2 


E.VULN:'L' 


Length of Unbind message 


; Connect Reject notification packet (Network —> TMM) 

.=E.VUCB+2 

E.VRR: 1 L 1 .BLKW 1 ; Reason for Rejection 

E.VRLN:*L 1 ? Length of Reject message 


Disconnect Notification packet (Network —> TMM) 
.=E.VUCB+2 


E.VRD:'L' .BLKW 
E.VDLN:'L' 


1 ; Reason for Disconnect 

; Length of Disconnect message 


; Disconnect Complete packet (TMM —> Network) 

.=E.VUCB+2 

E.VDCL:'L 1 ; Length of Disconnect Complete message 


.PSECT 


IF NB LST 


.NLIST 

; Turn listing back off 

IFF 


.MACRO 

EVNDF$ ; If not listing. 

.ENDM 

; macro to nothing 


. ENDC 


. ENDM 


EVNDF$ 
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.MACRO FllDF $,L,B 


VOLUME CONTROL BLOCK 


•ASECT 


V.TRCT:'L'.BLKW 1 
V. TYPE: 'L'.BLKB 1 
VT.FOR='B’ 
VT.SL1='B' 
VT.SL2='B' 
VT.ANS='B' 
VT.UNL='B' 
V.VCHA:'L'.BLKB 1 
VC.SLK= 1 B' 
VC.HLK='B' 
VC .DEA= 1 B' 
VC.PUB='B' 
VC .DUP= 1 B' 


; TRANSACTION COUNT 
; VOLUME TYPE DESCRIPTOR 
0 ; Foreign volume structure 

1 ; Files-11 Structure level 1 

2 ; Files-11 Structure level 2 

10 ; ANSI labeled tape 

11 ; Unlabeled tape 

; Volume characteristics 

1 ; Clear volume valid on dismount 

2 ; Unload the volume on dismount 

4 ; Deallocate the volume on dismount 

10 ; Set (clear) US.PUB on dismount 

20 ; Duplicate volume name; don't delete 

logicals 


F11DF$ 


V.LABL:'L' 

.BLKB 

14 

; Volume label (ASCII) 

V.PKSR:'L' 
V.SLEN:'L' 

.BLKW 

2 

; Pack serial number for error logging 
; Length of short VCB 

V.IFWI:'L' 

.BLKW 

1 

; INDEX FILE WINDOW 

V.FCB:'L' 

.BLKW 

2 

; FILE CONTROL BLOCK LIST HEAD 

V.IBLB:'L' 

.BLKB 

1 

; INDEX BIT MAP 1ST LBN HIGH BYTE 

V.IBSZ:'L' 

.BLKB 

1 

; INDEX BIT MAP SIZE IN BLOCKS 

.BLKW 

1 

; INDEX BITMAP 1ST LBN LOW BITS 

V.FMAX:'L' 

.BLKW 

1 

; MAX NO. OF FILES ON VOLUME 

V.WISZ:'L' 

.BLKB 

1 

; DEFAULT SIZE OF WINDOW IN RTRV PTRS 
; VALUE IS < 128. 

V.SBCL:'L' 

.BLKB 

1 

; STORAGE BIT MAP CLUSTER FACTOR 

V.SBSZ:'L' 

.BLKW 

1 

; STORAGE BIT MAP SIZE IN BLOCKS 

V.SBLB:'L' 

.BLKB 

1 

; STORAGE BIT MAP 1ST LBN HIGH BYTE 

V.FIEX:'L' 

.BLKB 

1 

; DEFAULT FILE EXTEND SIZE 


.BLKW 

1 

; STORAGE BIT MAP 1ST LBN LOW BITS 

V.VOWN:'L' 

.BLKW 

1 

; VOLUME OWNER * S UIC 

V.VPRO:'L' 

.BLKW 

1 

; VOLUME PROTECTION 

V.FPRO:'L' 

.BLKW 

1 

; VOLUME DEFAULT FILE PROTECTION 

V.FRBK:'L' 

.BLKB 

1 

; NUMBER OF FREE BLOCKS ON VOLUME HIGH BYTE 

V.LRUC:'L' 

.BLKB 

1 

; COUNT OF AVAILABLE LRU SLOTS IN FCB LIST 


.BLKW 

1 

; NUMBER OF FREE BLOCKS ON VOLUME LOW BITS 

V.STS:'L' 

.BLKB 

1 

; VOLUME STATUS BYTE, CONTAINING THE 
; FOLLOWING 

VS. 

IFW = 1 B 

'1 

; INDEX FILE IS WRITE ACCESSED 

VS. 

BMW='B 

'2 

; STORAGE BITMAP FILE IS WRITE ACCESSED 

V.FFNU:'L' 

.BLKB 

1 

; FIRST FREE INDEX FILE BITMAP BLOCK 

V.EXT:'L' 

.BLKW 

1 

; POINTER TO VCB EXTENSION 

V.HBLB:'L' 

.BLKW 

2 

; LBN of home block 

V.HBCS:'L' 
V.LGTH:'L' 

.BLKW 

2 

; Home block checksums 
; SIZE IN BYTES OF VCB 
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F11DF$ (Cont.) 


MOUNT LIST ENTRY 

EACH ENTRY ALLOWS ACCESS TO A SPECIFIED USER FOR A NON-PUBLIC DEVICE 

TO ALLOW EXPANSION, ONLY THE ONLY TYPE CODE DEFINED IS "1" FOR 
DEVICE ACCESS BLOCKS 


.ASECT 


.=0 


M.LNK:'L' .BLKW 1 
M.TYPE:'L'.BLKB 1 
MT.MLS='B' 1 
M.ACC:'L 1 .BLKB 1 
M.DEV: 1 L' .BLKW 1 
M.TIr'L' .BLKW 1 
M.LEN:'L' 


; LINK WORD 
; TYPE OF ENTRY 

; Mounted volume user access list 
NUMBER OF ACCESSES 
DEVICE UCB 
ACCESSOR TI: UCB 
LENGTH OF ENTRY 


FILE CONTROL BLOCK 


•ASECT 


.=0 


F.LINK: 

'L'.BLKW 

1 

? 

FCB CHAIN POINTER 

F.FNUM: 

'L'.BLKW 

1 

/ 

FILE NUMBER 

F.FSEQ: 

'L'.BLKW 

1 

f 

FILE SEQUENCE NUMBER 


.BLKB 

1 

} 

NOT USED 

F.FSQN: 

'L'.BLKB 

1 

r 

FILE SEGMENT NUMBER 

F.FOWN: 

'L'.BLKW 

1 

i 

FILE OWNER'S UIC 

F.FPRO: 

'L'.BLKW 

1 

} 

FILE PROTECTION CODE 

F.UCHA: 

'L'.BLKB 

1 

} 

USER CONTROLLED CHARACTERISTICS 

F.SCHA: 

'L'.BLKB 

1 

} 

SYSTEM CONTROLLED CHARACTERISTICS 

F.HDLB: 

'L'.BLKW 

2 

/ 

FILE HEADER LOGICAL BLOCK NUMBER 




r 

BEGINNING OF STATISTICS BLOCK 

F.LBN: 1 

L'.BLKW 

2 

} 

LBN OF VIRTUAL BLOCK 1 IF CONTIGUOUS 




r 

0 IF NON CONTIGUOUS 

F.SIZE: 

'L'.BLKW 

2 

} 

SIZE OF FILE IN BLOCKS 

F.NACS: 

'L'.BLKB 

1 

r 

NO. OF ACCESSES 

F.NLCK: 

'L'.BLKB 

1 

r 

NO. OF LOCKS 

S.STBK= 

'B'.-F.LBN 

t 

SIZE OF STATISTICS BLOCK 

F.STAT: 

'L' 


• 

FCB STATUS WORD 

F.NWAC: 

'L'.BLKB 

1 

• 

f 

NUMBER OF WRITE ACCESSORS 


.BLKB 

1 

r 

STATUS BITS FOR FCB CONSISTING OF 


FC.WAC=*B 1 

100000 

r 

SET IF FILE ACCESSED FOR WRITE 


FC.DIR='B' 40000 
FC.CEF= 1 B' 20000 
FC.FCO= 1 B' 10000 
1 
1 
1 
2 
1 
1 


F.DREF:'L' 

.BLKW 

F.DRNM:’L' 

.BLKW 

F.FEXT:'L' 

.BLKW 

F.FVBN:'L' 

.BLKW 

F.LKL:'L' 

.BLKW 

F.WIN:'L' 
F.LGTH:'L' 

.BLKW 


SET IF FCB IS IN DIRECTORY LRU 

SET IF DIRECTORY EOF NEEDS UPDATING 

SET IF TRYING TO FORCE DIRECTORY CONTIG 

DIRECTORY EOF BLOCK NUMBER 

1ST WORD OF DIRECTORY NAME 

POINTER TO EXTENSION FCB 

STARTING VBN OF THIS FILE SEGMENT 

POINTER TO LOCKED BLOCK LIST FOR FILE 

WINDOW BLOCK LIST FOR THIS FILE 

SIZE IN BYTES OF FCB 
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F11DF$ (Cont.) 


WINDOW 


.ASECT 


.=0 


W.ACT: 

'L' 

} 

t 

NUMBER OF ACTIVE MAPPING POINTERS 

WHEN NO SECONDARY POOL 

W.BLKS 

: 'L' 

} 

r 

BLOCK SIZE OF SECONDARY POOL SEGMENT 
WHEN SECONDARY POOL 

W.CTL: 

'L'.BLKW 1 

r 

r 

LOW BYTE = # OF MAP ENTRIES ACTIVE 

HIGH BYTE CONSISTS OF CONTROL BITS 


WI.RDV='B' 

400 

; READ VIRTUAL BLOCK ALLOWED IF SET 


WI.WRV='B' 

1000 

; WRITE VIRTUAL BLOCK ALLOWED IF SET 


WI.EXT='B 1 

2000 

; EXTEND ALLOWED IF SET 


WI .LCK='B' 

4000 

; SET IF LOCKED AGAINST SHARED ACCESS 


WI.DLK='B' 

10000 

; SET IF DEACCESS LOCK ENABLED 


WI.PND='B 1 

20000 

; WINDOW TURN PENDING BIT 


WI.EXL='B' 

40000 

; SET IF MANUAL UNLOCK DESIRED 


WI.WCK='B' 

100000 

; Data check all writes to file 

W.IOC: 

1 L' .BLKB 1 
.BLKB 1 


; COUNT OF I/O THROUGH THIS WINDOW 
; Reserved 

W.FCB: 

'L'.BLKW 1 


; FILE CONTROL BLOCK ADDRESS 

W.TCB: 

'L'.BLKW 1 


; TCB address of accessor 

W.UCB: 

'L'.BLKW 1 


; Original UCB address of device 

W.LKL: 

'L'.BLKW 1 


; POINTER TO LIST OF USERS LOCKED BLOCKS 

W.WIN: 

'L'.BLKW 1 


; WINDOW BLOCK LIST LINK WORD 


.IF NB, SYSDEF ; IF SYSDEF SPECIFIED IN CALL 

.IF NDF,P$$WND ; IF SECONDARY POOL WINDOWS NOT ALLOWED 


NON-SECONDARY POOL WINDOW BLOCK 

IF SECONDARY POOL WINDOWS ARE NOT ENABLED, THE WINDOW BLOCK 
CONTAINS THE CONTROL INFORMATION AND RETRIEVAL POINTERS. 


W.VBN:'L' .BLKB 1 
W.MAP:'L' 

W.WISZ:'L'.BLKB 1 
.BLKW 1 

W.RTRV:'L' 
W.SLEN='B'-4 


.IFF 


HIGH BYTE OF 1ST VBN MAPPED BY WINDOW 
DEFINE LABEL WITH ODD ADDRESS TO CATCH BAD 
REFS 

SIZE IN RTRV PTRS OF WINDOW (7 BITS) 

LOW ORDER WORD OF 1ST VBN MAPPED 

OFFSET TO 1ST RETRIEVAL POINTER IN WINDOW 

Dummy definition to prevent incorrect 
reference 

(-4 when rounded "up" is a VERY large block) 
IF WINDOWS IN SECONDARY POOL 


SECONDARY POOL WINDOW CONTROL AND MAPPING BLOCK 

IF SECONDARY POOL WINDOW BLOCKS ARE ENABLED, LUTN2 POINTS 
TO A CONTROL BLOCK IN SYSTEM POOL WHICH CONTAINS THE 
FOLLOWING CONTROL FIELDS AND THE MAPPING INFORMATION 
FOR THE SECONDARY POOL WINDOW. 
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F11DF$ (Cont.) 


W.MAP:'L' .BLKW 
W.SLEN:'L' 


ADDR TO THE MAPPING PTRS IN SECONDARY POOL 
Length of primary pool stub 


SECONDARY POOL WINDOW 

IF SECONDARY POOL WINDOW BLOCKS ARE ENABLED, THE RETRIEVAL 
POINTERS ARE MAINTAINED IN SECONDARY POOL IN THE FOLLOWING 
FORMAT. 


.=0 


ASSUME 


W.CTL,0 



• BLKB 

1 

; NUMBER OF 

ACTIVE MAPPING POINTERS 

W. USE: 'L' 

• BLKB 

1 

; STATUS OF 

BLOCK 

W.VBN:'L' 

• BLKB 

1 

; HIGH BYTE 

OF 1ST VBN MAPPED BY WINDOW 

W.WISZ:'L' 

• BLKB 

1 

; SIZE IN RTRV PTRS OF WINDOW (7 BITS) 

W.RTRV:'L' 

• BLKW 

1 

; LOW ORDER 
; OFFSET TO 

WORD OF 1ST VBN MAPPED 

1ST RETRIEVAL POINTER IN WINDOW 


> ENDC 
. ENDC 


; END SECONDARY POOL WINDOW CONDITIONAL 
; END SYSDEF CONDITIONAL 


; LOCKED 

r 

BLOCK 

•ASECT 

. =0 

L.LNK:'L' 

.BLKW 

L.WI1:'L' 

.BLKW 

L.VB1:'L' 

.BLKB 

L.CNT:'L' 

.BLKB 

.BLKW 

L.LKSZ: 'L 

• 

f 

i 


END OF DEFINITIONS 


LINK TO NEXT NODE IN LIST 
POINTER TO WINDOW FOR FIRST ENTRY 
HIGH ORDER VBN BYTE 
COUNT FOR ENTRY 
LOW ORDER VBN 


.PSECT 
•MACRO 
. ENDM 
. ENDM 


F11DF$ 

F11DF$ 

F11DF$ 


X,Y,Z 
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HDRDF$ 


.MACRO HDRDF$,L,B 


+ 

TASK HEADER OFFSET DEFINITIONS 

.ASECT 

= 0 


H.CSP:'L' 

.BLKW 

1 

;CURRENT STACK POINTER 

H.HDLN:'L' 

.BLKW 

1 

;HEADER LENGTH IN BYTES 

H.EFLM:'L' 

.BLKW 

2 

;EVENT FLAG MASK WORD AND ADDRESS 

H.CUIC:'L' 

.BLKW 

1 

;CURRENT TASK UIC 

H.DUIC:'L' 

.BLKW 

1 

;DEFAULT TASK UIC 

H.IPS:'L' 

.BLKW 

1 

;INITIAL PROCESSOR STATUS WORD (PS) 

H.IPC:'L' 

.BLKW 

1 

;INITIAL PROGRAM COUNTER (PC) 

H.ISP:'L' 

.BLKW 

1 

;INITIAL STACK POINTER (SP) 

H.ODVA:'L' 

.BLKW 

1 

;ODT SST VECTOR ADDRESS 

H.ODVL:'L' 

.BLKW 

1 

;ODT SST VECTOR LENGTH 

H.TKVA:'L' 

.BLKW 

1 

;TASK SST VECTOR ADDRESS 

H.TKVL:'L' 

.BLKW 

1 

;TASK SST VECTOR LENGTH 

H.PFVA:'L' 

.BLKW 

1 

;POWER FAIL AST CONTROL BLOCK ADDRESS 

H.FPVA:'L' 

.BLKW 

1 

;FLOATING POINT AST CONTROL BLOCK ADDRESS 

H.RCVA:'L' 

.BLKW 

1 

;RECIEVE AST CONTROL BLOCK ADDRESS 

H.EFSV:'L' 

.BLKW 

1 

;EVENT FLAG ADDRESS SAVE ADDRESS 

H.FPSA:'L' 

.BLKW 

1 

;POINTER TO FLOATING POINT/EAE SAVE AREA 

H.WND:'L' 

.BLKW 

1 

;POINTER TO NUMBER OF WINDOW BLOCKS 

H.DSW:'L' 

.BLKW 

1 

;TASK DIRECTIVE STATUS WORD 

H.FCS:'L' 

.BLKW 

1 

;FCS IMPURE POINTER 

H.FORT:'L' 

.BLKW 

1 

;FORTRAN IMPURE POINTER 

H.OVLY:'L' 

.BLKW 

1 

;OVERLAY IMPURE POINTER 

H.VEXT:'L' 

.BLKW 

1 

;WORK AREA EXTENSION VECTOR POINTER 

H.SPRI:'L' 

. BLKB 

1 

;PRIORITY DIFFERENCE FOR SWAPPING 

H.NML:'L' 

.BLKB 

1 

;NETWORK MAILBOX LUN 

H.RRVA:'L' 

.BLKW 

1 

;RECEIVE BY REFERENCE AST CONTROL BLOCK 
;ADDRESS 

H.X25:'L' 

.BLKB 

1 

; FOR USE BY X.25 SOFTWARE 


.BLKB 

1 

; FIVE RESERVED BYTES 


.BLKW 

2 

/ 

H.GARD:'L' 

.BLKW 

1 

;POINTER TO HEADER GUARD WORD 

H.NLUN:'L' 

.BLKW 

1 

;NUMBER OF LUN'S 

H.LUN:'L' 

.BLKW 

2 

;START OF LOGICAL UNIT TABLE 


+ 

LENGTH OF FLOATING POINT SAVE AREA 


H.FPSL='B'25.*2 

; + 

; WINDOW BLOCK OFFSETS 


.=0 

W.BPCB:'L'.BLKW 1 
W.BLVR:'L'.BLKW 1 
W.BHVR:'L'.BLKW 1 
W.BATT:'L'.BLKW 1 
W.BSIZ:'L'.BLKW 1 


;PARTITION CONTROL BLOCK ADDRESS 
;LOW VIRTUAL ADDRESS LIMIT 
;HIGH VIRTUAL ADDRESS LIMIT 
;ADDRESS OF ATTACHMENT DESCRIPTOR 
;SIZE OF WINDOW IN 32W BLOCKS 
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HDRDF$ (Cont.) 


W.BOFF: 

'L'•BLKW 

1 

W.BFPD: 

'L'.BLKB 

1 

W.BNPD: 

'L'.BLKB 

1 

W.BLPD: 
W.BLGH: 

'L'.BLKW 

'L' 

1 


.PSECT 

•MACRO HDRDF$ X,Y 
. ENDM 
. ENDM 


;PHYSICAL MEMORY OFFSET IN 32W BLOCKS 
;FIRST PDR ADDRESS 
;NUMBER OF PDR'S TO MAP 
;CONTENTS OF LAST PDR 
;LENGTH OF WINDOW DESCRIPTOR 
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HWDDF$ 


.MACRO HWDDF$,L,B 


+ 


; HARDWARE 

REGISTER 

ADDRESSES 

AND STATUS CODES 


MPCSR='B' 

177746 


;ADDRESS OF PDP-11/70 MEMORY 




;PARITY REGISTER 


MPAR='B' 

172100 


;ADDRESS OF FIRST MEMORY 




;PARITY REGISTER 


PIRQ='B' 

177772 


;PROGRAMMED INTERRUPT REQUEST 




;REGISTER 


PR0='B' 

0 


;PROCESSOR PRIORITY 

0 

PR1='B' 

40 


;PROCESSOR PRIORITY 

1 

PR4='B' 

200 


;PROCESSOR PRIORITY 

4 

PR5='B' 

240 


;PROCESSOR PRIORITY 

5 

PR6= 'B' 

300 


;PROCESSOR PRIORITY 

6 

PR7= 1 B' 

340 


;PROCESSOR PRIORITY 

7 

PS='B' 

177776 


;PROCESSOR STATUS WORD 

SWR='B' 

177570 


;CONSOLE SWITCH AND 

DISPLAY 




; REGISTER 


TPS='B' 

177564 


;CONSOLE TERMINAL PRINTER STATUS 




;REGISTER 


; + 

; EXTENDED 

ARITHMETIC ELEMENT 

REGISTERS 


. IF 

DF 

E$$EAE 



AC='B' 

177302 


ACCUMULATOR 


MQ='B' 

177304 


;MULTIPLIER-QUOTIEN' 

r 

SC='B' 

177310 


;SHIFT COUNT 


. ENDC 




; + 

; MEMORY MANAGEMENT 

HARDWARE 

REGISTERS AND STATUS CODES 


. IF 

DF 

M$$MGE 




KDSAR0='B' 

172360 

;KERNEL 

D 

PAR 

0 

KDSDR0='B' 

172320 

;KERNEL 

D 

PDR 

0 

KISAR0='B' 

172340 

;KERNEL 

I 

PAR 

0 

KINAR0='B' 

KISAR0 

;KERNEL 

I 

PAR 

0 

KISAR5='B' 

172352 

;KERNEL 

I 

PAR 

5 

KINAR5='B' 

KISAR5 

;KERNEL 

I 

PAR 

5 

KISAR6='B' 

172354 

;KERNEL 

I 

PAR 

6 

KINAR6= 1 B' 

KISAR6 

;KERNEL 

I 

PAR 

6 

KISAR7='B' 

172356 

;KERNEL 

I 

PAR 

7 

KINAR7='B' 

KISAR7 

;KERNEL 

I 

PAR 

7 

KISDR0='B' 

172300 

;KERNEL 

I 

PDR 

0 

KISDR6='B' 

172314 

;KERNEL 

I 

PDR 

6 
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HWDDF$ (Cont.) 


KISDR7=’B' 

172316 

;KERNEL 

I PAR 

7 

SISDR0='B' 

172200 

;SUPERVISOR 

I 

PDR 0 

UDSAR0='B' 

177660 

;USER D 

PAR 

0 


UDSDR0='B' 

177620 

;USER D 

PDR 

0 


UISAR0='B' 

177640 

;USER I 

PAR 

0 


UISAR4='B' 

177650 

;USER I 

PAR 

4 


UISAR5='B' 

177652 

;USER I 

PAR 

5 


UISAR6='B' 

177654 

;USER I 

PAR 

6 


UISAR7='B' 

177656 

;USER I 

PAR 

7 


UISDR0='B' 

177600 

;USER I 

PDR 

0 


UISDR4='B' 

177610 

;USER I 

PDR 

4 


UISDR5='B' 

177612 

;USER I 

PDR 

5 


UISDR6='B' 

177614 

;USER I 

PDR 

6 


UISDR7='B' 

177616 

;USER I 

PDR 

7 


UBMPR= 1 B 1 

170200 

;UNIBUS 

MAPPING REGISTER 0 

CMODE='B ' 

. IFTF 

140000 

;M$$MGE 

;CURRENT 

1 MODE 

FIELD OF PS WORD 


PMODE='B 1 


30000 


SR0='B' 
SR3='B' 


, IFT 


, ENDC 


;M$$MGE 


177572 

172516 


;PREVIOUS MODE FIELD OF PS WORD 


;SEGMENT STATUS REGISTER 0 
;SEGMENT STATUS REGISTER 3 


; FEATURE 

SYMBOL DEFINITIONS 


FE.EXT='B' 

1 


J22-BIT EXTENDED MEMORY SUPPORT 

FE.MUP='B' 

2 


MULTI-USER PROTECTION SUPPORT 

FE.EXV='B' 

4 


;EXECUTIVE IS SUPPORTED TO 20K 

FE.DRV='B' 

10 


;LOADABLE DRIVER SUPPORT 

FE.PLA='B' 

20 


;PLAS SUPPORT 

FE.CAL='B' 

40 


;DYNAMIC CHECKPOINT SPACE ALLOCATION 

FE•PKT='B' 

100 


;PREALLOCATION OF I/O PACKETS 

FE.EXP='B' 

200 


;EXTEND TASK DIRECTIVE SUPPORTED 

FE.LS1='B' 

400 


;PROCESSOR IS AN LSI-11 

FE.OFF='B' 

1000 


;PARENT OFFSPRING TASKING SUPPORTED 

FE.FDT='B ' 

2000 


;FULL DUPLEX TERMINAL DRIVER 

FE.X25='B' 

4000 


;X.25 COM EXECUTIVE LOADED (1=YES) 

FE.DYM='B' 

10000 


;DYNAMIC MEMORY ALLOCATION SUPPORTED 

FE.CEX='B’ 

20000 


;COM EXEC IS LOADED 

FE.MXT='B' 

40000 


MCR EXIT AFTER EACH COMMAND MODE 

FE.NLG='B' 

100000 


;LOGINS DISABLED - MULTI-USER SUPPORT 

; + 

; SECOND FEATURE MASK 

SYMBOL 

DEFINITIONS 

F2.DAS=’B' 

1 

;KERNEL DATA SPACE (M-PLUS ONLY) 

F2.LIB='B' 

2 

SUPERVISOR MODE LIBRARIES 

F2.MP='B' 

4 

MULTIPROCESSING SUPPORT 
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F2.EVT='B' 

10 

F2.ACN='B' 

20 

F2.SDW='B' 

40 

F2.POL='B' 

100 

F2.WND='B' 

200 

F2.DPR='B' 

400 

F 2.1RR='B 1 

1000 

F2.GGF='B' 

2000 

F2.RAS='B' 

4000 

F2.AHR='B' 

10000 

F2.RBN='B' 

20000 

F2.SWP='B' 

40000 

F2.STP='B' 

100000 

; + 



;EVENT TRACE SUPPORT 
;CPU ACCOUNTING 
;SHADOW RECORDING 
; SECONDARY POOLS 
SECONDARY POOL FILE WINDOWS 
^DIRECTIVE PARTITION SUPPORT 
;INSTALL, REQUEST AND REMOVE SUPPORT 
;GROUP GLOBAL EVENT FLAG SUPPORT 
;RECEIVE/SEND DATA PACKET SUPPORT 
;ALT. HEADER REFRESH AREAS SUPPORTED 
;ROUND ROBIN SCHEDULING SUPPORT 
;EXECUTIVE LEVEL DISK SWAPPING SUPPORT 
;EVENT FLAG MASK IS IN THE TCB (1=YES) 


THIRD FEATURE MASK SYMBOL DEFINITIONS 


r ~ 

F3.CRA='B' 

1 

F 3.NWK='B 1 

2 

F3.EIS='B' 

4 

F3.STM='B' 

10 

F3.UDS='B' 

20 

F3.PRO='B' 

40 

F3.XHR='B' 

100 

F3.AST='B' 

200 

F3.11S='B' 

400 

F3.CLI='B’ 

1000 

F3.TCM='B' 

2000 

F3.PMN='B' 

4000 

F3.WAT='B' 

10000 

F3.RLK='B' 

20000 

F3.SHF='B' 

40000 

;F3.RES='B 1 

1 100000 

; HARDWARE 
i ” 

FEATURE 

HF.UBM='B' 

1 

HF.EIS= 'B' 

2 

HF.QB='B' 

4 

HF.CIS='B' 

200 

HF.FPP='B' 

100000 


SPONTANEOUS CRASH (1=YES) 

SYSTEM HAS NETWORK SUPPORT 
SYSTEM REQUIRES THE EXTENDED INST. SET 
SYSTEM HAS SET SYSTEM TIME DIRECTIVE 
USER DATA SPACE (M-PLUS ONLY) 

PROTO TCBS OUT OF POOL " 

EXTERNAL HEADER SUPPORT " 

SYSTEM HAS AST SUPPORT 

SYSTEM IS RSX-11S 

SYSTEM HAS MULTIPLE CLI SUPPORT 

TERMINAL COMMON (M-PLUS ONLY) 

POOL MONITORING SUPPORT 
WATCHDOG TIMER SUPPORT 
'RMS' RECORD LOCKING SUPPORT 
MEMORY SHUFFLER SUPPORTED 
RESERVED FOR FUTURE EXPANSION OF 11M 


;SYSTEM HAS A UNIBUS MAP (1=YES) 

;SYSTEM HAS EXTENDED INSTRUCTION SET 
;SYSTEM HAS A QBUS BACKPLANE (1=YES) 
;SYSTEM HAS COMMERCIAL INSTRUCTION SET 
;SYSTEM SUPPORTS FLOATING POINT (l=NO) 


.MACRO HWDDF$ X,Y 
. ENDM 
. ENDM 
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.MACRO ITBDF$ L,B 

r 

r + 

; INTERRUPT TRANSFER BLOCK (ITB) OFFSET DEFINITIONS 



.IF DF 

A$$TRP 




.MCALL 
PKTDF$ 

PKTDF$ 


; DEFINE AST BLOCK OFFSETS 


. ENDC 





.ASECT 

.=0 




X.LNK:'L' 

.BLKW 

1 


LINK WORD FOR ITB LIST STARTING 

X.JSR:'L' 

JSR 

R5,@#0 


CALL $INTSC 

X.PSW:'L' 

• BLKB 

1 


LOW BYTE OF PSW FOR ISR 


. BLKB 

1 


UNUSED 

X.ISR:'L' 

.BLKW 

1 


ISR ENTRY POINT (APR5 MAPPING) 

X.FORK:'L 

.BLKW 

1 


FORK BLOCK 

THREAD WORD 


.BLKW 

1 


FORK PC 


.BLKW 

1 


SAVED R5 


.BLKW 

1 


SAVED R4 


.IF DF 

M$$MGE 



X.REL:'L' 

.BLKW 

1 

1 

I RELOCATION BASE FOR APR5 


.ENDC 




X.DSI:'L' 

.BLKW 

1 

; ADDRESS OF DIS.INT. ROUTINE 

X.TCB:'L' 

.BLKW 

1 

1 

; TCB ADDRESS OF OWNING TASK 


. IF NB 

SYSDEF 




.IF DF 

A$$TRP 




.BLKW 

1 

J 

: A.DQSR FOR AST BLOCK 

X.AST:'L' 

.BLKB 

A.PRM 

4 

: AST BLOCK 


.ENDC 




X.VEC:'L' 

.BLKW 

1 


VECTOR ADDRESS (IF AST SUPPORT, 
THIS IS FIRST AND ONLY AST 





PARAMETER) 

X.VPC:'L' 

.BLKW 

1 


SAVED VECTOR PC 

X.LEN:'L' 

.ENDC 



LENGTH IN BYTES OF ITB 


.PSECT 

.MACRO 

ITBDF$ 

X,Y,Z 



. ENDM 

ITBDF$ 




. ENDM 

ITBDF$ 
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LCBDF$ 



MACRO LCBDF$,L,B 


+ 


LOGICAL ASSIGNMENT CONTROL BLOCK 

THE LOGICAL ASSIGNMENT CONTROL BLOCK (LCB) IS USED TO ASSOCIATE A 
LOGICAL NAME WITH A PHYSICAL DEVICE UNIT. LCB'S ARE LINKED TOGETHER 
TO FORM THE LOGICAL ASSIGNMENTS OF A SYSTEM. ASSIGNMENTS MAY BE ON 
A SYSTEM WIDE OR LOCAL (TERMINAL) BASIS. 


.ASECT 


. — u 

L.LNK:'L' .BLKW 1 
L.NAM:'L' .BLKW 1 
L.UNIT:'L' .BLKB 1 
L.TYPE:'L' .BLKB 1 
L.UCB:'L' .BLKW 1 
L.ASG:'L' .BLKW 1 
L.LGTH='B' .-L.LNK 


= 0 



LINK TO NEXT LCB 

LOGICAL NAME OF DEVICE 

LOGICAL UNIT NUMBER 

TYPE OF ENTRY (0=SYSTEM WIDE) 

TI UCB ADDRESS 

ASSIGNMENT UCB ADDRESS 

LENGTH OF LCB 


.PSECT 


MACRO 

ENDM 

ENDM 


LCBDF$,X,Y 
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.MACRO MTADF$,L,B 
.ASECT 

ANSI MAGTAPE SPECIFIC DATA STRUCTURES 


VOLUME SET CONTROL BLOCK OFFSET DEFINITIONS (VSCB) 


; VOLUME 
} 

SET AND 

PROCESS 

CONTROL SECTION 

.=0 

V.TCNT:'L 

.BLKW 

1 

TRANSACTION COUNT 

V.TYPE:'L 

. BLKB 

1 

;VOLUME TYPE DESCRIPTOR 

V.VCHA:’L 

' .BLKB 

1 

;VOLUME CHARACTERISTICS 

V.LABL:'L 

.BLKB 

12. 

;FILE SET ID (FIRST SIX BYTES) 

V.NXT:'L' 

.BLKW 

1 

;PTR TO NEXT VSCB NODE 

V.MVL:'L' 

.BLKW 

1 

;PTR TO MOUNTED VOL LIST 

V.UVL:'L' 

.BLKW 

1 

;PTR TO UNMOUNTED VOL LIST 

V.ATL:'L' 

• BLKW 

1 

;ATL ADDR OF ACCESSING TASK 
; TCB IN RSX11M 

V.UCB:'L' 

.BLKW 

1 

;ADDR OF CURRENT UCB OR PUD 

V.RVOL:'L 

' .BLKB 

1 

;CURRENT RELATIVE VOL # 

V.MOU:'L' 

• BLKB 

1 

;MOUNT MODE BYTE 

V.TCHR:'L 

' .BLKW 

1 

;UINT CHAR. FOR ALL UNITS USED FOR VOL 

V.SEQN:'L 

' .BLKW 

1 

/•CURRENT FILE SEQUENCE # 

V.SECN:'L 

' .BLKW 

1 

;CURRENT FILE SECTION # 

V.TPOS:'L 

' .BLKB 

1 

/•POSITION OF TAPE IN TM' S TO NXT HDR1 

V.PSTA: 'L 

' .BLKB 

1 

;PROCESS STATUS BYTE 

V.TIMO:'L 

' .BLKW 

1 

/•BLOCKED PROCESS TIMEOUT COUNTER 

V.STAT:'L 

' .BLKW 

3 

; STATUS WORDS USED BY COMMAND 
/•EXECUTION MODULES 

V.TRTB: 'L 

' .BLKB 

1 

/•TRANSLATION CONTROL BYTE 

V.EFTV:'L 

' .BLKB 

1 

;FOR MAG TO RETURN IE.EOF, EOT, EOV 

t 

; LABEL DATA SECTION 


V.BLKL:'B 

' .BLKW 

1 

;BLOCK LENGTH 

V.RECL:'B 

' .BLKW 

1 

;RECORD LENGTH 

V.FNAM:'L 

' .BLKW 

3 

;FILE NAME 

V.FTYP:'L 

' .BLKW 

1 

;FILE TYPE 

V.FVER:'L 

' .BLKW 

1 

;FILE VERSION # 

V.CDAT:’L 

1 .BLKW 

2 

/•CREATION DATE 

V.EDAT:'L 

' .BLKW 

2 

;EXPRIATION DATE 

V.BLKC:'L 1 

1 .BLKW 

2 

;BLOCK COUNT FOR FILE SECTION 

V.RTYP:'L 

1 .BLKB 

1 

;RECORD TYPE 

V.FATT:'L 

' .BLKB 

1 

;FILE ATTRIBUTES FOR CARRIAGE CONTROL 


.BLKB 

30. 

REMAINDER OF FILE ATTRIBUTES 


; NULL WINDOW SECTION 

r 

V.WIND:'L 1 .BLKW 4. ; NULL WINDOW 

****** 

r 


B-28 











RSX-llM SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS 
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V.MST2: 

* L 1 

.BLKW 

1 

;MAGTAPE STATUS BITS 

V.FABY: 

1 L 1 

• BLKB 

1 

;FILE ACCESSIBILITY BYTE (HDR1) 



.BLKB 

1 

; SPARE 

V.ANSN: 

1 L 1 

.BLKB 

17. 

;ANSI 17 CHARACTER FILE NAME 

V.BOFF: 

1 L 1 

.BLKB 

1. 

;BUFFER OFFSET 

V.DENS: 

1 L 1 

.BLKB 

1. 

;REQUESTED UNIT DENSITY 

V.DRAT: 

'L' 

.BLKB 

1. 

;DEFAULT RECORD ATTRIBUTES 

V.DBLK: 

1 L 1 

.BLKW 

1. 

;DEFAULT BLOCK SIZE 

V.DREC: 

•L* 

.BLKW 

1. 

;DEFAULT RECORD SIZE 


. ***** 

# 



S•VSCB= 

. 



;SIZE OF VSCB 


.PSECT 

; DEFINE OFFSETS INTO NULL WINDOW SECTION 
.ASECT 

.=0 

W.CTL: .BLKW 1 ;CONTROL WORD IN WINDOW 

V.WINC=V.WIND+W.CTL ; CNTRL WORD IN NULL WINDOW 


.PSECT ; RELATIVE TO THE VSCB 

• MOUNTED VOLUME LIST OFFSET DEFININTIONS (MVL) 


.=0 

.ASECT 

.IF DF R$$11M 


M.NXT:'L' 

.BLKW 1 
. ENDC 

;PTR TO NXT MVL NODE (11M) 

M.UIC:'L' 

.BLKW 1 

;OWNER UIC FROM RVOL #1 

M.CH:'L' 

.BLKW 1 

; U.CH/U.VP (1ID) 

M.PROT:'L' 

.BLKW 1 

.IF NDF R$$11M 

;PROTECTION U.AR IN 11D 


.BLKW 2 

; ACP WORDS 1ID 

M.NXT:'L' 

.BLKW 1 
.ENDC 

;PTR TO NEXT MVL NODE (11D) 

M.RVOL:'L' 

.BLKB 1 

;RELATIVE VOL # OF MOUNTED VOLUME 

M.STAT:'L' 

.BLKB 1 

;VOLUME STATUS 

M.VIDP:'L' 

.BLKW 1 

;VOLUME ID POINTER 

M.UCB:'L' 

.BLKW 1 

;ADDR OF ASSOC UCB OR PUD 

S.MVL=. 

.PSECT 

;SIZE OF MVL NODE 

/ 

; UNMOUNTED 

VOLUME AND VOLUME 

LIST OFFSET DEFINITIONS (UVL) 

r 

.=0 

.ASECT 


L.NXT:'L' 

.BLKW 1 

;PTR TO NXT UVL NODE 

L.VOL1:'L' 

.BLKB 1 

;REL VOL # OF l'ST VOL IN NODE 

L.VOL2:'L' 

.BLKB 1 

;REL VOL # OF 2'ND VOL IN NODE 

L.VID1:'L' 

.BLKB 6 

;VOL ID OF l'ST VOL IN NODE 

L.VID2:'L' 

.BLKB 6 

;VOL ID OF 2'ND VOL IN NODE 

S.UVL =. 

• 

;SIZE OF UVL NODE 

f 

.PSECT 


} 

; SYSTEM DATA STRUCTURE CONTENT 

/ 

VALUES 

; VSCB VALUES 
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V.MOU VALUES 


VM.OLD= *B 1 

200 

;OLD .FL300 VOLUME — VM.BYP WILL ALSO 
; BE SET 

VM•BYP= 1 B 1 

100 

;BYPASS LABEL PROCESSING 

VM.ULB= 1 B * 

40 

;UNLABELED TAPE 

VM•FSC='B 1 

20 

;OVERRIDE FILE SET ID CHECK 

VM . E XC = 1 B * 

10 

;OVERRIDE EXPIRATION DATE CHECK 

; V.MST2 VALUES[ [B 


V2.INI='B' 

1 

;MAG WANTS US TO INITIALIZE NEXT OUTPUT 

V2.XH2='B' 

2 

;THIS FILE HAS NO HDR2, DON'T WRITE EOF2 

V2.XH3='B' 

4 

;THIS FILE HAS NO HDR3, DON'T WRITE EOF3 

V2.NH3='B' 

10 

;DON'T WRITE HDR3/EOX3 LABELS 

V2.0AC='B' 

20 

;OVERRIDE FILE/VOLUME ACCESSIBILITY 

; V.PSTA VALUES - UNBLOCKED 

TRANSITION STATE 

VP.RM='B' 

2 

;READ DATA MODE 

VP.WM='B' 

4 

;WRITE DATA MODE 

VP.UCM='B' 

6 

;UNLABELLED CREATE POSITIONING MODE 

VP.SM='B' 

10 

;SEARCH MODE 

VP.MOU='B' 

20 

;MOUNT MODE 

VP.RWD='B' 

40 

;REWIND OR VOL VERIFICATION WAIT 

VP.VFY='B' 

VP.RWD 


VP.POS='B 1 

100 

;PROCESS IN POSITIONING MODE (MULTI-SECTION 
;FILE) 


BLOCKED STATE = -(UNBLOCKED TRANSITION STATE VALUES) 


PROCESS TIMED OUT BIT 0=1 
VP.TO=l 


NULL WINDOW CONTROL BIT DEFINITIONS 


WI.RDV='B' 

400 

; ACCESSED 

FOR 

READ 

WI.WRV='B' 

1000 

; ACCESSED 

FOR 

WRITE 

WI.EXT='B' 

2000 

;ACCESSED 

FOR 

EXTEND 

WI.LCK='B' 

r 

4000 

;LOCKED 



} 

; MVL VALUES 

IN THE M.STAT 

FIELD 




MS.VER='B' 
MS.RID='B' 
MS.NMO='B ' 
MS.TMO='B' 
MS.EXP='B' 


200 

1 

2 

4 

10 


;VOL ID NOT VERIFIED 
;VOL ID TO BE READ NOT CHECKED 
;MOUNT MESSAGE NOT GIVEN YET 
;ONE TIMEOUT ALREADY EXPRIED 
;EXPIRATION DATE MESSAGE GIVEN 


MISC BITS USED IN MOUNT (STORED IN V.STS) 


MO.OVR ='B' 
MO.UIC='B' 
MO.PRO='B' 
MO.160='B' 


1 

2 

4 

10 


OVER RIDE VOL NAME SWITCH 
EXPLICIT UIC GIVEN 
EXPLICIT PROTECTION GIVEN 
1600 BPI SPECIFIED 


• ENDM 
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.MACRO PCBDF$ L,B 


PARTITION CONTROL BLOCK OFFSET DEFINITIONS 


1 ;LINK TO NEXT PARTITION PCB 

1 ;PRIORITY OF PARTITION 

1 ;I/0 + I/O STATUS BLOCK COUNT 

2 ;PARTITION NAME IN RAD50 

1 ;POINTER TO NEXT SUBPARTITION 

1 ;POINTER TO MAIN PARTITION 


•IF NB SYSDEF 


.IF NDF M$$MGE 

P.HDR:'L' 

. ENDC 


. IFTF 

P.REL:'L' .BLKW 1 
P.BLKS:'L' 

P.SIZE:'L'.BLKW 1 


P.WAIT:'L'.BLKW 1 
P.SWSZ:'L'.BLKW 1 
P.BUSY:'L'.BLKB 2 
P.OWN:'L' 

P.TCB:'L' .BLKW 1 
P.STAT:'L'.BLKW 1 

. IFT 


.IF DF M$$MGE 

P.HDR: 1 L' .BLKW 1 ;POINTER TO HEADER CONTROL BLOCK 

.ENDC 


P.PRO:'L' .BLKW 1 ;PROTECTION WORD [DEWR,DEWR,DEWR,DEWR] 

P.ATT:'L' .BLKW 2 ;ATTACHMENT DESCRIPTOR LISTHEAD 


;POINTER TO HEADER CONTROL BLOCK 


;STARTING PHYSICAL ADDRESS OF PARTITION 

;SIZE OF PARTITION IN: 

; UNMAPPED SYSTEMS - BYTES 
; MAPPED SYSTEMS - 32 WORD BLOCKS 
;PARTITION WAIT QUEUE LISTHEAD (2 WORDS) 
;PARTITION SWAP SIZE (SYSTEM ONLY) 

;PARTITION BUSY FLAGS 

;TCB ADDRESS OF OWNER TASK 
;PARTITION STATUS FLAGS 


.=0 

P.LNK: 
P.PRI: 
P.IOC: 
P.NAM: 
P.SUB: 


'L' 

'L' 

'L' 

'L' 

'L' 


.ASECT 

.BLKW 

.BLKB 

.BLKB 

.BLKW 

.BLKW 


P.MAIN:'L'.BLKW 


.IF NDF P$$LAS 

P.LGTH='B'P.PRO ;LENGTH OF PARTITION CONTROL BLOCK 

.IFF 
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P.LGTH='B'. 


;LENGTH OF PARTITION CONTROL BLOCK 


.ENDC 

.IFF 

.PSECT 


+ 

PARTITION STATUS WORD BIT DEFINITIONS 


PS.OUT='B' 

100000 

PS.CKP='B' 

40000 

PS.CKR='B' 

20000 

PS.CHK='B' 

10000 

PS.FXD='B 1 

4000 

PS.PER='B' 

2000 

PS.LIO='B' 

1000 

PS.NSF= 1 B' 

400 

PS,COM='B' 

200 

PS.PIC='B 1 

100 

PS.SYS='B' 

40 

PS.DRV='B 1 

20 

PS.DEL='B' 

10 

PS.APR='B' 

7 


PARTITION IS OUT OF MEMORY(1=YES) 
PARTITION CHECKPOINT IN PROGRESS (1=YES) 
PARTITION CHECKPOINT IS REQUESTED (1=YES) 
PARTITION IS NOT CHECKPOINTABLE (1=YES) 
PARTITION IS FIXED (1=YES) 

PARITY ERROR IN PARTITION (1=YES) 

MARKED BY SHUFFLER FOR LONG I/O (1=YES) 
PARTITION IS NOT SHUFFLEABLE (1=YES) 
LIBRARY OR COMMON BLOCK (1=YES) 

POSITION INDEPENDENT LIBRARY OR COMMON 
(1=YES) 

SYSTEM CONTROLLED PARTITION (1=YES) 

DRIVER IS LOADED IN PARTITION (1=YES) 
PARTITION SHOULD BE DELETED WHEN NOT 
ATTACHED (1=YES) 

STARTING APR NUMBER MASK 


+ 

ATTACHMENT DESCRIPTOR OFFSETS 


•ASECT 

= 0 


A.PCBL:'L' 

.BLKW 

1 

;PCB ATTACHMENT QUEUE THREAD WORD 

A.PRI:'L' 

. BLKB 

1 

;PRIORITY OF ATTACHED TASK 

A.IOC:'L' 

.BLKB 

1 

;I/O COUNT THROUGH THIS DESCRIPTOR 

A.TCB:'L' 

.BLKW 

1 

;TCB ADDRESS OF ATTACHED TASK 

A.TCBL:'L' 

.BLKW 

1 

;TCB ATTACHMENT QUEUE THREAD WORD 

A.STAT:'L' 

.BLKB 

1 

;STATUS BYTE 

A.MPCT:'L' 

.BLKB 

1 

;MAPPING COUNT OF TASK THRU THIS DESCRIPTOR 

A.PCB:'L' 
A.LGTH='B' 

.BLKW 

• 

1 

;PCB ADDRESS OF ATTACHED TASK 
;LENGTH OF ATTACHMENT DESCRIPTOR 


+ 

ATTACHMENT DESCRIPTOR STATUS BYTE BIT DEFINITIONS 


.PSECT 


AS.DEL='B' 

10 

; TASK 

HAS 

AS.EXT='B' 

4 

; TASK 

HAS 

AS.WRT='B' 

2 

;TASK 

HAS 

AS.RED='B' 

1 

; TASK 

HAS 


DELETE ACCESS (1=YES) 
EXTEND ACCESS (1=YES) 
WRITE ACCESS (1=YES) 
READ ACCESS (1=YES) 


.ENDC 


.MACRO PCBDF$ X,Y,Z 

. ENDM 
. ENDM 
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PKTDF$ 


.MACRO PKTDF$,L,B 


ASYNCHRONOUS SYSTEM TRAP CONTROL BLOCK OFFSET DEFINITIONS 

SOME POSITIONAL DEPENDENCIES BETWEEN THE OCB AND THE AST CONTROL 
BLOCK ARE RELIED UPON IN THE ROUTINE $FINXT IN THE MODULE SYSXT. 


.ASECT 
.=177774 
A.KSR5:'L' 
A.DQSR:'L' 


A.CBL:'L' 


• BLKW 
. BLKW 

• BLKW 
.BLKW 


SUBROUTINE KISAR5 BIAS (A.CBL=0) 

DEQUEUE SUBROUTINE ADDRESS (A.CBL=0) 

AST QUEUE THREAD WORD 

LENGTH OF CONTROL BLOCK IN BYTES 

IF A.CBL = 0, THE AST CONTROL BLOCK IS 

TO BE DEALLOCATED BY THE DEQUEUE SUBROUTINE 

POINTED TO BY A.DQSR MAPPED VIA APR 5 

VALUE A.KSR5. THIS IS CURRENTLY USED ONLY 

BY THE FULL DUPLEX TERMINAL DRIVER FOR 

UNSOLICITED CHARACTER ASTS. 

IF THE LOW BYTE OF A.CBL = 0, AND THE 
HIGH BYTE IS NOT = 0, THE AST CONTROL BLOCK 
IS A SPECIFIABLE AST, WITH LENGTH, C.LGTH. 
IF THE HIGH BYTE OF A.CBL = 0 AND THE LOW 
BYTE > 0, THEN THE LOW BYTE IS THE LENGTH 
OF THE AST CONTROL BLOCK. IF THE HIGH BYTE 
OF A.CBL = 0 AND THE LOW BYTE IS NEGATIVE, 
THIS IS A KERNEL AST. SEE BELOW FOR 


A.BYT:’ 

L' 

.BLKW 1 

;NUMBER OF BYTES TO ALLOCATE ON 

f TASK STACK 

A.AST: ' 

L* 

.BLKW 1 

;AST TRAP ADDRESS 


A.NPR: ' 

L' 

.BLKW 1 

;NUMBER OF AST PARAMETERS 


A.PRM:' 

L 1 

.BLKW 1 

JFIRST AST PARAMETER 


r 

; THE SPECIFIABLE AST 

CODES MUST NOT BE 0. 


AS•FPA= 

'B ' 

1 

;CODE FOR FLOATING POINT AST 


AS.RCA= 

'B' 

2 

;CODE FOR RECEIVE DATA AST 


AS.RRA= 

'B' 

3 

;CODE FOR RECEIVE BY REFERENCE 

AST 

AS•PFA= 

'B' 

4 

;CODE FOR POWERFAIL AST 


AS.REA= 

*B 1 

5 

;CODE FOR REQUESTED EXIT (ABORT) AST 

AS•CAA= 

'B* 

6 

;CODE FOR COMMAND ARRIVAL AST FOR CLIS 

r 

; BIT VALUES IN A.PRM+5 


AF•XCC= 

'B * 

1 

;ATTACHED FOR ALL BUT CONTROL-C 

(TF.XCC) 

AF.NOT= 

'B' 

2 

;ATTACHED FOR ALL NOTIFICATION 

(TF.NOT) 

AF.OOB= 

'B ' 

4 

;ACB IS FOR OUT-OF-BAND AST 


AF.AST= 

'B* 

10 

;ACB HANDLES UNSOL. INPUT CHAR 

AST'S (TF.AST) 

AF.ESQ= 

'B 1 

20 

;ATTACHED FOR ESCAPE SEQUENCES 

(TF.ESQ) 

AF.LCK= 

*B' 

40 

;ACB IS LOCKED 


AF.QUE= 

1 B 1 

100 

;ACB IS QUEUED 


AF.MDE= 

'B' 

200 

;ACB IS MARKED FOR DELETE 
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; ABORTER SUBCODES FOR ABORT AST (AS.REA) TO BE RETURNED ON USER'S 
; STACK 

AB.NPV='B' 1 ;ABORTER IS NONPRIVILEGED (1=YES) 

AB.TYP='B' 2 ;ABORT FROM DIRECTIVE (0=YES) 

;ABORT FROM CLI COMMAND (1=YES) 


+ 

KERNEL AST CONTROL BLOCK DEFINITIONS 

THE LOW BYTE OF A.CBL FOR A KERNEL AST HAS THE FOLLOWING FORMAT: 
BIT #200 ALWAYS EQUALS 1 

BIT #100 IS ZERO IF $SGFIN MUST BE CALLED DURING AST 
PROCESSING THE REMAINING SIX BITS ARE USED AS THE 
KERNEL AST TYPE FIELD 

BECAUSE THERE ARE ONLY 6 BITS AVAILABLE TO THE KERNEL AST 
INDEX FIELD, ONLY (2**6)-1 KERNEL AST TYPES ARE POSSIBLE. 


AK.BUF='B' 

200 

;BUFFERED I/O COMPLETION AST 

AK.OCB='B' 

201 

;OFFSPRING EXIT 


AK.GBI='B' 

202 

;GENERAL BUFFERED I/O 

AST 

AK.GGF='B' 

303 

;GROUP GLOBAL RUNDOWN 

AST 


+ 

OFFSPRING CONTROL BLOCK DEFINITIONS 

SOME POSITIONAL DEPENDENCIES EXIST BETWEEN THE OCB AND THE AST 
CONTROL BLOCK IN ROUTINE $FINXT IN MODULE SYSXT 


.=0 


O.LNK:'L' 

• BLKW 

1 

;OCB LINK WORD 

O.MCRL:'L' 

. BLKW 

1 

;ADDRESS OF MCR COMMAND LINE 

O.PTCB:'L' 

.BLKW 

1 

;PARENT TCB ADDRESS 

O.AST:'L' 

.BLKW 

1 

;EXIT AST ADDRESS 

O.EFN:'L' 

.BLKW 

1 

;EXIT EVENT FLAG 

O.ESB:'L 

.BLKW 

1 

;EXIT STATUS BLOCK VIRTUAL ADDRESS 

O.STAT:'L' 

.BLKW 

8. 

;EXIT STATUS BUFFER 

O.LGTH='B' 

• 


;LENGTH OF OCB 

; + 

; I/O PACKET OFFSET 

DEFINITIONS 


.ASECT 


.=0 

I.LNK:'L' 

.BLKW 

1 

;I/O QUEUE THREAD WORD 

I.PRI:'L' 

. BLKB 

1 

;REQUEST PRIORITY 

I.EFN:'L' 

.BLKB 

1 

;EVENT FLAG NUMBER 

I.TCB:'L' 

.BLKW 

1 

;TCB ADDRESS OF REQUESTOR 

I.LN2:'L' 

.BLKW 

1 

;POINTER TO SECOND LUN WORD 

I.UCB:'L' 

.BLKW 

1 

;POINTER TO UNIT CONTROL BLOCK 

I.FCN:'L' 

.BLKW 

1 

;I/O FUNCTION CODE 
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I.IOSB:'L' .BLKW 1 
.BLKW 1 
.BLKW 1 
I.AST:'L' .BLKW 1 
I.PRM:'L' .BLKW 1 
•BLKW 6 
.BLKW 1 


;VIRTUAL ADDRESS OF I/O STATUS BLOCK 
;I/0 STATUS BLOCK RELOCATON BIAS 
;I/0 STATUS BLOCK ADDRESS 
;AST SERVICE ROUTINE ADDRESS 
;RESERVED FOR MAPPING PARAMETER #1 
;PARAMETERS 1 TO 6 

;USER MODE DIAGNOSTIC PARAMETER WORD 


FOLLOWING ARE DEFINITIONS FOR FLAG BITS IN I.PRM+11 
(DSA DRIVERS INTERNAL USE ONLY) 


IP.FAK='B' 
IP.ABO='B' 
IP.PND='B' 
IP.UMR='B' 

I.ATTL='B ' . 


20 

40 

100 

200 


I.LGTH='B'. 


;IOP IS PSEUDO IOP 

/(MUDRV)ABORT COMMAND MUST BE ISSUED FOR IOP 
;(MUDRV)ABORT COMMAND WAS ISSUED FOR IOP 
;A UMR WAIT BLOCK IS IN USE FOR THIS I/O 

;MINIMUM LENGTH OF I/O PACKET (USED BY 
;FILE SYSTEM TO CALCULATE MAXIMUM 
;NUMBER OF ATTRIBUTES) 

;LENGTH OF I/O REQUEST CONTROL BLOCK 


DEFINE OFFSETS IN I/O PACKET EXTENSION (IOPX) 




.ASECT 



.=0 

I.XLNK: 

1 L 1 

.BLKW 

1 

;LINK WORD 


I.XIOP: 

'L' 

.BLKW 

1 

;I/O PACKET ADDRESS 


I.XTCB: 

'L' 

.BLKW 

1 

;TCB ADDRESS OF REQUESTING TASK 


I.XMOD: 

'L' 

.BLKW 

2 

/MODIFIER WORDS (NOTE: 2ND WORD MUSI 

? BE 

I.XRBF: 

•L' 

.BLKW 

2 

/SPECIFIED AND MUST BE ZERO.) 

/READ DATA BUFFER ADDRESS APR BIAS 


I.XRBL: 

'L' 

.BLKW 

1 

/READ DATA BUFFER VIRTUAL ADDRESS 
/READ DATA BUFFER LENGTH 


I.XTMO: 

'L' 

.BLKW 

1 

/READ TIME-OUT INTERVAL 


I.XPBF: 

'L' 

.BLKW 

2 

/PROMPT BUFFER ADDRESS APR BIAS 


I.XPBL: 

' L 1 

.BLKW 

1 

/PROMPT BUFFER VIRTUAL ADDRESS 
/PROMPT BUFFER LENGTH 


I.XPBV: 

*L' 

.BLKW 

1 

/PROMPT BUFFER VERTICAL FORMS CONTROL 

I.XTTB: 

•L* 

.BLKW 

2 

/TERMINATOR TABLE ADDRESS APR BIAS 


I.XTTL: 

* L 1 

.BLKW 

1 

/TERMINATOR TABLE VIRTUAL ADDRESS 
/TERMINATOR TABLE LENGTH 


I.XDBF: 

1 L 1 

.BLKW 

2 

/DEFAULT INPUT BUFFER ADDRESS APR BIAS 

I.XDBL: 

'L' 

.BLKW 

1 

/DEFAULT INPUT BUFFER VIRTUAL ADDRESS 
/DEFAULT INPUT BUFFER LENGTH 


+ 

GROUP GLOBAL EVENT FLAG CONTROL BLOCK OFFSETS 


.=0 


G.LNK:'L' 

.BLKW 

1 

G.GRP:'L' 

. BLKB 

1 

G.STAT:'L' 

• BLKB 

1 

G.CNT:'L' 

.BLKW 

1 

G.EFLG:'L' 

.BLKW 

2 

G.LGTH='B' 




;LINK WORD 
;GROUP NUMBER 
; STATUS BYTE 
;ACCESS COUNT 
; EVENT FLAGS 
;LENGTH OF GROUP 


GLOBAL CONTROL BLOCK 
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; STATUS BYTE DEFINITIONS 

GS.DEL='B'l ;GROUP MARKED FOR DELETE 


; + 


; EXECUTIVE POOL MONITOR CONTROL FLAGS 

r “ 

; $POLST IS THE SYNCHRONIZATION WORD BETWEEN THE EXEC AND POOL MONITOR 


PC.HIH='B' 
PC.LOW='B' 
PC,ALF ='B 1 
PC.XAF ='B 1 
PC.XIT='B' 
PC.NRM='B' 
PC.ALM= 1 B 1 


1 

2 

4 

10 

200 

PC.HIH*400 
PC.LOW*400 


HIGH POOL LIMIT CROSSED (1=YES) 

LOW POOL LIMIT CROSSED (1=YES) 

FAILED TO ALLOCATE LARGE BLOCK (1=YES) 
FAILED TO ALLOCATE SMALL BLOCK (1=YES) 
FORCE POOL MONITOR TASK TO EXIT 
POOL TASK INHIBIT BIT FOR HIGH POOL 
POOL TASK INHIBIT BIT FOR LOW POOL 


; $POLFL IS THE POOL USAGE CONTROL WORD 


PF.INS='B' 
PF.LOG='B' 
PF.REQ='B' 


40 

100 

200 


PF.ALL='B' 177777 


;REJECT NONPRIVILEGED INS/RUN/REM 

;LOGINS ARE DISABLED 

;STALL REQUEST OF NONPRIV. TASKS 

;TAKE ALL POSSIBLE ACTIONS TO SAVE POOL 


CLI PARSER BLOCK (CPB) DEFINITIONS 


.=0 


C.PTCB:'L' 

• BLKW 

1 

;ADDRESS OF CLI'S TCB 

C.PNAM:'L' 

. BLKW 

2 

;CLI NAME 

C.PSTS:'L' 

.BLKW 

1 

; STATUS MASK 

C.PDPL:'L' 

. BLKB 

1 

;LENGTH OF DEFAULT PROMPT 

C.PCPL:'L' 

.BLKB 

1 

;LENGTH OF CNTRL/C PROMPT 

C.PRMT:'L' 



;START OF ASCII PROMPT STRINGS 


;THE DEFAULT STRING IS CONCANTENATED 
;WITH THE ~C STRING 


STATUS BIT DEFINITIONS 


CP.NUL= 1 B 1 

1 

CP.MSG='B' 

2 

CP.LGO='B 1 

4 

CP.DSB='B' 

10 

CP.PRV='B' 

20 

CP.SGL='B' 

40 

CP.NIO='B' 

100 

CP.RST='B' 

200 

CP.EXT='B' 

400 

f 

; IDENTIFIER Cl 


; PASS EMPTY COMMAND LINES TO CLI 

;CLI DESIRES SYSTEM MESSAGES 

;CLI WANTS COMMANDS FROM LOGGED OFF TTYS 

;CLI IS DISABLED 

; USER MUST BE PRIV TO SET TTY TO THIS CLI 
;DON'T HANDLE CONTINUATIONS (M-PLUS ONLY) 
;MCR..., HEL, BYE DO NO I/O TO TTY 
;HEL, BYE ALSO DO NOT SET CLI ETC. 

;ABILITY TO SET TO THIS CLI IS RESTRICTED 
;TO THE CLI ITSELF 

;PASS TASK EXIT PROMPT REQUESTS TO CLI 


CODES 0 - 127. ARE RESERVED FOR USE BY DIGITAL, 
CODES 128. - 255. ARE RESERVED FOR USE BY CUSTOMERS 
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r 

CM.INE='B 1 1 
CM.IND= 1 B 1 2 
CM.CEN='B' 3 
CM.CDS='B 1 4 
CM.ELM='B' 5 
CM.EXT='B' 6 
CM.LKT='B 1 7 
CM.RMT='B' 8. 
CM.MSG='B' 9. 


;CLI INITIALIZED ENABLED 
;CLI INITIALIZED DISABLED 
;CLI ENABLED 
;CLI DISABLED 
;CLI BEING ELIMINATED 
;CLI MUST EXIT IMMEDIATELY 
;NEW TERMINAL LINKED TO CLI 
;TERMINAL REMOVED FROM CLI 
;GENERAL MESSAGE TO CLI 


ANCILLARY CONTROL BLOCK (ACB) DEFINITIONS 


.=0 


A.REL:'L' 

• BLKW 

A.DIS:'L' 

. BLKW 

A.MAS:'L' 

.BLKW 

A.NUM:'L' 

. BLKB 

A.FLEN:'L' 

• BLKB 

A.LIN:'L' 

.BLKW 

A.ACC:'L' 

.BLKB 

A.STA:'L' 

.BLKB 

A.PLEN='B' 

• 

!=a.lin 

A.IMAP: 'L' 

.BLKW 

A.IBUF:'L' 

.BLKW 

A.ILEN:'L' 

.BLKW 

A.SMAP:'L' 

.BLKW 

A.SBUF:'L' 

.BLKW 

A.SLEN:'L' 

.BLKW 

A.IOS:'L' 

.BLKW 

A.RES='B' 

• 

f 

} DEFINE THE FLAG 

UA.ACC='B' 

1 

UA.PRO='B' 

2 

UA.ECH='B' 

4 

UA.TYP='B' 

10 

UA.SPE='B' 

20 

UA.PUT='B 1 

40 

UA.CAL='B' 

100 

UA.COM='B' 

200 

UA.ALL='B' 

400 

UA.TRN='B' 

1000 

UA.TRA='B 1 

2000 


1 ;ACD RELOCATION BIAS 

1 ;ACD DISPATCH TABLE POINTER 

2 ;ACT FUNCTION MASK 

1 ;ACD IDENTIFICATION NUMBER 

1 ;LENGTH IN BYTES OF FULL ACB 

1 ;ACD LINK WORD 

1 ;ACD ACCESS COUNT 

1 ;ACD STATUS BYTE 

;LENGTH IN BYTES OF PROTOTYPE ACB 

;FULL ACB OVERLAPS PROTOTYPE ACB 
1 ;ACD INTERRUPT BUFFER RELOCATION BIAS 

1 ;ACD INTERRUPT BUFFER ADDRESS 

1 ;ACD INTERRUPT BUFFER LENGTH 

1 ;ACD SYSTEM STATE BUFFER RELOCATION BIAS 

1 ;ACD SYSTEM STATE BUFFER ADDRESS 

1 ;ACD SYSTEM STATE BUFFER LENGTH 

2 ;ACD I/O STATUS 

;START OF ACB RESERVED FOR USE BY THE ACD 


;ACCEPT THIS CHARACTER 
;PROCESS THIS CHARACTER 
;ECHO THIS CHARACTER 

;FORCE THIS CHARACTER INTO TYPEAHEAD 
;THIS CHARACTER HAS A SPECIAL ECHO 
? PUT THIS CHARACTER IN THE INPUT BUFFER 
;CALL THE ACD BACK AFTER THE TRANSFER 
;COMPLETE THE INPUT REQUEST 

;ALLOW PROCESSING OF THIS I/O REQUEST 
;TRANSLATE CHARACTERS FROM OUTPUT QIO 
;TRANSFER CHARACTERS WHEN I/O COMPLETES 

DEFINE THE ACD ENTRY POINTS (OFFSETS INTO THE DISPATCH TABLE) 

.=0 

;I/0 REQUEST ACCEPTANCE ENTRY POINT 
;I/O REQUEST DEQUEUE ENTRY POINT 
;POWER FAILURE ENTRY POINT 
; INPUT COMPLETION ENTRY POINT 


A.ACCE:'L' 

.BLKW 

1 

A.DEQU:'L' 

.BLKW 

1 

A.POWE:'L' 

.BLKW 

r 

A.INPU:'L' 

.BLKW 

i 
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A.OUTP:'L' .BLKW 1 

A.CONN:'L' .BLKW 1 
A.DISC:'L' .BLKW 1 
A.RECE:'L' .BLKW 1 
A.PROC:'L' .BLKW 1 
A.TRAN:'L' .BLKW 1 
A.CALL:'L* .BLKW 1 
! 

; DEFINE THE STATUS 

AS,DLT='B 1 1 
AS.DIS='B' 2 

.PSECT 


;OUTPUT COMPLETION ENTRY POINT 
;CONNECTION ENTRY POINT 
DISCONNECTION ENTRY POINT 
;INPUT CHARACTER RECEPTION ENTRY POINT 
;INPUT CHARACTER PROCESSING ENTRY POINT 
;OUTPUT QIO CHARACTER TRANSLATION ENTRY POINT 
;CALL ACD BACK AFTER TRANSFER ENTRY POINT 

BITS IN A.STA OF THE PROTOTYPE ACB 

;ACD IS MARKED FOR DELETE 
;ACD IS DISABLED 


MACRO PKTDF$ X,Y,Z 

ENDM 

ENDM 






RSX-11M SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS 

SCBDF$ 


THE STATUS CONTROL BLOCK (SCB) DEFINES THE STATUS OF A DEVICE 
CONTROLLER. THERE IS ONE SCB FOR EACH CONTROLLER IN A SYSTEM. 
THE SCB IS POINTED TO BY UNIT CONTROL BLOCKS. TO EXPAND ON THE 
TELETYPE EXAMPLE ABOVE, EACH TELETYPEWRITER TYPE INTERFACED VIA 


; A DL11-A 

WOULD 

HAVE 

A 

SCB SINCE EACH DL11-A IS AN INDEPENDENT 

; INTERFACE 

UNIT. 

THE 

TELETYPES INTERFACED VIA THE DH11 WOULD 

; ALSO EACH 

HAVE 

AN SCB 

SINCE THE DH11 IS A SINGLE CONTROLLER BUT 

; MULTIPLEXES MANY UNITS 

IN PARALLEL. 


.ASECT 



.=177772 





S.RCNT:'L' 

.BLKB 

1 


;NUMBER OF REGISTERS TO COPY ON ERROR 

S.ROFF:'L' 

.BLKB 

1 


;OFFSET TO FIRST DEVICE REGISTER 

S.BMSV:'L' 

.BLKW 

1 


;SAVED I/O ACTIVE BITMAP AND POINTER TO EMB 

S.BMSK:'L' 

.BLKW 

1 


;DEVICE I/O ACTIVE BIT MASK 

S.LHD:'L' 

.BLKW 

2 


;CONTROLLER I/O QUEUE LISTHEAD 

S.PRI:'L' 

.BLKB 

1 


;DEVICE PRIORITY 

S.VCT:'L' 

.BLKB 

1 


;INTERRUPT VECTOR ADDRESS /4 

S.CTM:'L' 

.BLKB 

1 


,-CURRENT TIMEOUT COUNT 

S.ITM:'L' 

.BLKB 

1 


; INITIAL TIMEOUT COUNT 

S.CON:'L' 

.BLKB 

1 


;CONTROLLER INDEX 

S.STS:'L' 

.BLKB 

1 


CONTROLLER STATUS (0=IDLE,1=BUSY) 

S.CSR:'L' 

.BLKW 

1 


;ADDRESS OF CONTROL STATUS REGISTER 

S.PKT:'L' 

.BLKW 

1 


;ADDRESS OF CURRENT I/O PACKET 

S.FRK:'L' 

.BLKW 

1 


;FORK BLOCK LINK WORD 

S.DMCS:'L' 




;DM11-BB CSR FOR FDX TTDRV 


.BLKW 

1 


;FORK-PC 


.BLKW 

1 


;FORK-R5 


.BLKW 

1 


;FORK-R4 


.IF NB SYSDEF 


.IF DF L$$DRV & M$$MGE 

.BLKW 1 ;FORK-DRIVER RELOCATION BASE 



. ENDC 


S.PORT:'L' 

S.PBIA='B' S.PORT+2 
S.QST='B' S.PORT+4 
S.BSYU='B' S.PORT+6 


S.CCB:'L' 

S.MPR:'L' .BLKW 6 
.BLKW 1 
S.UMHD:'L' .BLKW 2 
S.UMCT:'L' .BLKW 1 


FIRST THREE CHAR. OF PORT NAME (RAD50) 

BIAS OF PORT COMMON 

ADDRESS OF QST, CONTROLLER STATE TABLE 
ADDRESS OF UNIT CORRESPONDING TO OLDEST CMD 
ZERO IF THERE ARE NO OUTSTANDING CMDS. 
MIXED MASSBUS CHANNEL CONTROL BLOCK 
11/70 EXTENDED MEMORY UNIBUS DEVICE C-BLOCK 
BUFFER WORD 

LIST HEAD FOR UMR ASSIGNMENT BLOCK(S) 

COUNT OF AVAILABLE UMR ASSIGNMENT BLOCK(S) 


. IFF 
.PSECT 
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STATUS CONTROL BLOCK PRIORITY BYTE CONDITION CODE STATUS BIT 
DEFINITIONS 


SP.ElP='B' 1 
SP.ENB='B 1 2 
SP.LOG='B' 4 
SPARE=10 


MAPPING ASSIGNMENT BLOCK (FOR UNIBUS MAPPING REGISTER ASSIGNMENT) 


;ERROR IN PROGRESS (1=YES) 

;ERROR LOGGING ENABLED (0=YES) 
;ERROR LOGGING AVAILABLE (1=YES) 
;SPARE BIT 


.ASECT 

.=0 

M.LNK:'L' .BLKW 1 

M.UMRA:'L' .BLKW 1 
M.UMRN:'L' .BLKW 1 
M.UMVL:'L' .BLKW 1 
M.UMVH: 1 L 1 .BLKB 1 
M.BFVH:'L' .BLKB 1 
M.BFVL:'L' .BLKW 1 
M.LGTH='B'. 

. ENDC 


;LINK WORD 

JADDRESS OF FIRST ASSIGNED UMR 
;NUMBER OF UMR'S ASSIGNED * 4 
;LOW 16 BITS MAPPED BY 1ST ASSIGNED UMR 
;HIGH 2 BITS MAPPED IN BITS 4 AND 5 
;HIGH 6 BITS OF PHYSICAL BUFFER ADDRESS 
? LOW 16 BITS OF PHYSICAL BUFFER ADDRESS 
;LENGTH OF MAPPING ASSIGNMENT BLOCK 


.PSECT 


• MACRO SCBDF$ f X,Y,Z 
. ENDM 
. ENDM 
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.MACRO TCBDF$,L,B 


+ 

TASK CONTROL BLOCK OFFSET AND STATUS DEFINITIONS 
TASK CONTROL BLOCK 


SEVERAL PIECES OF PRIVILEGED CODE EXIST THAT CREATE TCBS FROM 
OTHER TCBS. SINCE THESE PIECES OF CODE ARE GENERALLY OPTIMIZED 
FOR SPEED AND DO NOT USE THE SYMBOLIC OFFSETS PROVIDED BELOW, 
ANY CHANGE IN THE TCB MUST ALSO BE MADE TO EACH OF THESE PIECES 
OF CODE. THE KNOWN LIST OF SUCH PIECES OF CODE IS AS FOLLOWS: 

LIBRARY MODULE COMMENT 


RSX11M DRSPW TCB CREATED FOR RPOI$ DIRECTIVE 

MCR MCROV,MCRDIS MULTIUSER TASK DISPATCHING 


•ASECT 


.=0 

T.LNK:'L' 

. BLKW 

1 

;UTILITY LINK WORD 

T.PRI:'L' 

. BLKB 

1 

;TASK PRIORITY 

T.IOC:'L' 

. BLKB 

1 

;I/O PENDING COUNT 

T.CPCB:'L' 

.BLKW 

1 

;POINTER TO CHECKPOINT PCB 

T.NAM:'L' 

.BLKW 

2 

;TASK NAME IN RAD50 

T.RCVL:'L' 

.BLKW 

2 

;RECEIVE QUEUE LISTHEAD 

T.ASTL:'L' 

.BLKW 

2 

;AST QUEUE LISTHEAD 

T.EFLG:'L' 

.BLKW 

2 

;TASK LOCAL EVENT FLAGS 1-32 

T.UCB:'L' 

.BLKW 

1 

;UCB ADDRESS FOR PSEUDO DEVICE 'TI' 

T.TCBL:'L' 

.BLKW 

1 

;TASK LIST THREAD WORD 

T.STAT:'L' 

.BLKW 

1 

;FIRST STATUS WORD (BLOCKING BITS) 

T.ST2:'L' 

.BLKW 

1 

;SECOND STATUS WORD (STATE BITS) 

T.ST3:'L' 

.BLKW 

1 

;THIRD STATUS WORD (ATTRIBUTE BITS) 

T.DPRI:'L' 

.BLKB 

1 

;TASK'S DEFAULT PRIORITY 

T.LBN:'L' 

.BLKB 

3 

;LBN OF TASK LOAD IMAGE 

T.LDV:'L' 

.BLKW 

1 

;UCB ADDRESS OF LOAD DEVICE 

T.PCB:'L' 

.BLKW 

1 

;PCB ADDRESS OF TASK PARTITION 

T.MXSZ:'L' 

.BLKW 

1 

;MAXIMUM SIZE OF TASK IMAGE (MAPPED ONLY) 

T.ACTL:'L' 

.BLKW 

1 

;ADDRESS OF NEXT TASK IN ACTIVE LIST 

T.SAST:'L' 

.BLKW 

1 

;SPECIFIED AST LISTHEAD 


.BLKB 

1 

;RESERVED BYTE (CURRENTLY MUST BE 0) 

T.TIO:'L' 

.BLKB 

1 

JBUFFERED I/O COUNT 

T.TKSZ:'L' 

.BLKW 

1 

;TASK SIZE (FROM L$BLDZ IN LABEL BLK) IN: 




; UNMAPPED SYSTEMS - BYTES 

; MAPPED SYSTEMS - 32 WORD BLOCKS 




;TASK SIZE (FROM L$BMXZ IN LABEL BLK) 

;FOR RSX11S SYSTEMS ONLY 




; MAPPED SYSTEMS - 32 WORD BLOCKS 

; UNMAPPED SYSTEMS - BYTES 

$$$ = . 



;MARK START OF PLAS AREA 

T.ATT:'L' 

.BLKW 

2 

ATTACHMENT DESCRIPTOR LISTHEAD 

T.OFF:'L' 

.BLKW 

1 

;OFFSET TO TASK IMAGE IN PARTITION 
;IF A$$HDR IS DEFINED, THIS WORD ALSO 
;INCLUDES THE LENGTH OF THE ALTERNATE 
;HEADER REFRESH AREA STORED IN T.HDLN 


.BLKB 

1 

;RESERVED 
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;SREF WITH EFN COUNT IN ALL RECEIVE QUEUES 
;RECEIVE BY REFERENCE LISTHEAD 

;POINT TO START OF PLAS AREA 
;P$$LAS 

;MARK START OF PARENT OFFSPRING TASKING AREA 

;OFFSPRING CONTROL BLOCK LISTHEAD 
;OUTSTANDING OFFSPRING COUNT 

;POINT TO START OF PARENT OFFSPRING AREA 
;P$$OFF 

;MARK START OF EVENT FLAG MASK AREA 

;EVENT FLAG MASK WORD 
;EVENT FLAG MASK ADDRESS 

.IF NDF S$$TOP&T$$BUF 

•=$$$ ;PO-INT TO START OF EVENT FLAG MASK AREA 

.ENDC ;S$$TOP&T$$BUF 

$$$=. 

T.HDLN:'L' .BLKB 1 ;TASK HEADER LENGTH IN 32-WORD BLOCKS 

.IF NDF A$$HDR 

•=$$$ ;NOT SUPPORTED IF NDF 

.ENDC ;A$$HDR 

$$$=. 

T.GGF:'L' .BLKB 1 ;GROUP GLOBAL USE COUNT FOR TASK 

.IF NDF R$$SND&G$$EFN!A$$CLI&G$$EFN 

• =$$$ 

.ENDC 

.EVEN 

T.LGTH='B' . ;LENGTH OF TASK CONTROL BLOCK 

T.EXT='B'0 ;LENGTH OF TCB EXTENSION 

. IFF 


T.SRCT:'L' .BLKB 1 
T.RRFL:'L' 


.=$$$ 


. BLKW 2 

,IF NDF P$$LAS 

, ENDC 

.IF NB SYSDEF 


$$$ = . 


T.OCBH:'L' .BLKW 2 


T.RDCT:’L' 


.=$$$ 


.BLKW 1 

.IF NDF P$$OFF 

.ENDC 


$$$=. 

T.EFLM:'L' .BLKW 2 
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TASK STATUS DEFINITIONS 

FIRST STATUS WORD (BLOCKING BITS) 


TS.EXE='B' 

100000 

TS.RDN='B' 

40000 

TS.MSG='B' 

20000 

TS.NRP='B' 

10000 

TS.RUN='B' 

4000 

TS•HLD='B' 

2000 

TS.STP='B' 

1000 

TS.OUT= 1 B' 

400 

TS.CKP='B' 

200 

TS.CKR='B' 

100 


;TASK NOT IN EXECUTION (1=YES) 

;I/O RUN DOWN IN PROGRESS (1=YES) 

;ABORT MESSAGE BEING OUTPUT (1=YES) 

;TASK MAPPED TO NONRESIDENT PARTITION (1=YES) 
;TASK IS RUNNING ON ANOTHER PROCESSOR (1=YES) 
;TASK HALF-LOADED BY TASK LOADER 
;TASK EXTERNALLY BLOCKED VIA CLI COMMAND 
;TASK IS OUT OF MEMORY (1=YES) 

;TASK IS BEING CHECKPOINTED (1=YES) 

;TASK CHECKPOINT REQUESTED (1=YES) 


+ 

TASK BLOCKING STATUS MASK 


TS.BLK='B'TS.CKP!TS.CKR!TS.EXE!TS.MSG!TS.NRP!TS.OUT!TS.RDN!TS.STP 


+ 

SECOND STATUS WORD (STATE BITS) 


T2.AST='B' 100000 
T 2.DST='B' 40000 
T2.CHK='B' 20000 
T2.CKD='B' 10000 


T2.SEF='B' 4000 
T2.FXD='B' 2000 
T2.REX='B' 1000 
T2.CAF='B' 400 
T2.HLT='B' 200 
T2.ABO='B' 100 
T2.STP='B' 40 
T2.STP='B' 20 
T2.SPN='B' 10 
T2.SPN='B' 4 
T2.WFR='B' 2 
T 2.WFR= 1 B' 1 


AST IN PROGRESS (1=YES) 

AST RECOGNITION DISABLED (1=YES) 

TASK NOT CHECKPOINTABLE (1=YES) 
CHECKPOINTING DISABLED (1=YES) 

TASK STOPPED FOR EVENT FLAGS (1=YES) 

TASK FIXED IN MEMORY (1=YES) 

ABORT AST EFFECTED OR IN PROGRESS (1=YES) 
DYN CHECKPOINT SPACE ALLOCATION FAILURE 
TASK IS BEING HALTED (1=YES) 

TASK MARKED FOR ABORT (1=YES) 

SAVED T2.STP ON AST IN PROGRESS 
TASK STOPPED (1=YES) 

SAVED T2.SPN ON AST IN PROGRESS 
TASK SUSPENDED (1=YES) 

SAVED T2.WFR ON AST IN PROGRESS 
TASK IN WAITFOR STATE (1=YES) 


+ 

THIRD STATUS WORD (ATTRIBUTE BITS) 


T3.ACP='B' 100000 
T 3•PMD='B' 40000 
T3.REM='B' 20000 
T3.PRV='B' 10000 
T3.MCR='B' 4000 

T3.SLV='B' 2000 
T3.CLI='B' 1000 
T3.RST='B' 400 
T 3.NSD='B' 200 


fANCILLARY CONTROL PROCESSOR (1=YES) 

;DUMP TASK ON SYNCHRONOUS ABORT (0=YES) 

;REMOVE TASK ON EXIT (1=YES) 

;TASK IS PRIVILEGED (1=YES) 

;TASK REQUESTED AS EXTERNAL MCR FUNCTION 
;(1=YES) 

;TASK IS A SLAVE TASK (1=YES) 

;TASK IS A COMMAND LINE INTERPRETER (1=YES) 
;TASK IS RESTRICTED (1=YES) 

;TASK DOES NOT ALLOW SEND DATA 
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T3.CAL='B' 

100 

; TASK HAS 

CHECKPOINT SPACE IN 

TASK IMAGE 

T3.ROV='B' 

40 

;TASK HAS 

RESIDENT OVERLAYS 


T3.NET='B' 

20 

;NETWORK : 

PROTOCOL LEVEL 


T3.GFL='B' 

10 

;TASK HAS 

ITS GRP GBL EVENT FLAGS LOCKED 

; ='B' 

4 

;RESERVED 

FOR FUTURE USE 


T3.SWS='B' 

2 

PRESERVED 

FOR USE BY SOFTWARE 

SERVICES 

; = 1 B' 

1 

PRESERVED 

FOR FUTURE USE 



• ENDC 


.PSECT 

.MACRO TCBDF$ X,Y,Z 
. ENDM 
. ENDM 
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.MACRO UCBDF$,L,B,TTDEF,SYSDF 


UNIT CONTROL BLOCK 

THE UNIT CONTROL BLOCK (UCB) DEFINES THE STATUS OF AN INDIVIDUAL 
DEVICE UNIT AND IS THE CONTROL BLOCK THAT IS POINTED TO BY THE 
FIRST WORD OF AN ASSIGNED LUN. THERE IS ONE UCB FOR EACH DEVICE 
UNIT OF EACH DCB. THE UCB'S ASSOCIATED WITH A PARTICULAR DCB ARE 
CONTIGUOUS IN MEMORY AND ARE POINTED TO BY THE DCB. UCB'S ARE 
VARIABLE LENGTH BETWEEN DCB'S BUT ARE OF THE SAME LENGTH FOR A 
SPECIFIC DCB. TO FINISH THE TELETYPE EXAMPLE ABOVE, EACH UNIT 
ON BOTH INTERFACES WOULD HAVE A UCB. 


.ASECT 

.IF NB SYSDF 


.IF DF E$$DVC 



.IF DF 

M$$MUP 

;IS U•OWN THERE? 

.=177766 




. IFF 




.=177770 




. ENDC 



U.IOC:'L' 

.BLKW 

2 

;I/O COUNT SINCE MOUNT (ERROR LOG DEVS 
;ONLY) 

U.ERSL:'L' 

. BLKB 

1 

;SOFT ERROR LIMIT 

U.ERHL:'L' 

.BLKB 

1 

;HARD ERROR LIMIT 

U.ERSC:'L' 

.BLKB 

1 

;SOFT ERROR COUNT 

U.ERHC:'L' 

.BLKB 

1 

;HARD ERROR COUNT 


.ENDC 




.ENDC 




.=177772 
U.MUP:'L' 



MULTIUSER PROTECTION FLAG WORD 

U.CLI:'L' 

.BLKW 

1 

;TCB OF COMMAND LINE INTERPRETER 

U.LUIC:'L' 

.BLKW 

1 

;LOGIN UIC - MULTI USER SYSTEMS ONLY 

U.OWN:'L' 

.BLKW 

1 

;OWNING TERMINAL - MULTI USER SYSTEMS 
;ONLY 

U.DCB:'L' 

.BLKW 

1 

;BACK POINTER TO DCB 

U.RED:'L' 

.BLKW 

1 

;POINTER TO REDIRECT UNIT UCB 

U.CTL:'L' 

.BLKB 

1 

;CONTROL PROCESSING FLAGS 

U.STS:'L' 

.BLKB 

1 

;UNIT STATUS 

U.UNIT:'L' 

.BLKB 

1 

;PHYSICAL UNIT NUMBER 

U.ST2:'L' 

.BLKB 

1 

;UNIT STATUS EXTENSION 

U.CW1:'L' 

.BLKW 

1 

;FIRST DEVICE CHARACTERISTICS WORD 

U.CW2:'L' 

.BLKW 

1 

;SECOND DEVICE CHARACTERISTICS WORD 

U.CW3:'L' 

.BLKW 

1 

;THIRD DEVICE CHARACTERISTICS WORD 

U. CW 4: 1 L ' 

.BLKW 

1 

;FOURTH DEVICE CHARACTERISTICS WORD 

U.SCB:'L' 

.BLKW 

1 

;POINTER TO SCB 

U.ATT:'L' 

.BLKW 

1 

;TCB ADDRESS OF ATTACHED TASK 

U.BUF:'L' 

.BLKW 

1 

;RELOCATION BIAS OF CURRENT I/O REQUEST 


.BLKW 

1 

;BUFFER ADDRESS OF CURRENT I/O REQUEST 
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U.CNT: 

1 L' 

. BLKW 1 

;BYTE COUNT OF CURRENT I/O 

REQUEST 

U.ACP= 

*B * 

U.CNT+2 

;ADDRESS OF TCB OF MOUNTED 

ACP 

U.VCB= 


U.CNT+4 

;ADDRESS OF VOLUME CONTROL 

BLOCK 

U•CBF= 

'B ' 

U.CNT+2 

;CONTROL BUFFER RELOCATION 

AND ADDRESS 

U.KCSR 

= * B * 

U.CNT+2 

;CSR ADDRESS OF KMC-11 


U.KCS6 = 

= *B 1 

U.KCSR+2 

;CSR+6 OF KMC-11 



; MAGTAPE DRIVER 

DEFINITIONS 

U.SPC='B' 

U.CNT+6 

;SPACING COUNT 

U.SUB='B' 

U.CNT+6 

;SUBCONTROLLER, PHYSICAL UNIT #. 

U.FNUM='B' 

U.CNT+10 

;FORMATTER NUMBER 

U.FCDE='B ' 

U.CNT+12 

;FUNCTION CODE AND INDEX 


r 

MSCP/TMSCP 

1 DRIVER UCB OFFSETS 

U.UTIL='B' 

U.VCB+2 


;UNIT STATE WORD 

; DEFINITIONS FOR U 

.UTIL 

BITS 

UU.SER='B' 

1 


;SERIAL MODE 

UU.RCT='B' 

2 


;(DUDRV)RCT IN PROGRESS 

UU.AVN='B' 

4 


;UNIT IS WAITING FOR OTHER UNITS TO SPIN 
;DOWN 

UU.GUS='B' 

10 


;UNIT MUST HAVE A GUS COMMAND ISSUED 

UU.ONL='B' 

20 


;UNIT MUST HAVE A ONL COMMAND ISSUED 

UU.SPC='B' 

40 


;SPECIAL ONLINE TRANSITION 

UU.ATN='B' 

100 


;UNIT HAS SENT ATTENTION MESSAGE 

UU.RDY='B' 

200 


;UNIT IS READY 

UU.ABO= 1 B' 

400 


;IF SET, XXCAN SET UU.SER FLAG FOR UNIT 

UU.SIO='B' 

1000 


;THIS UNIT CAN STALL I/O 

UU.IOS='B' 

2000 


;THIS UNIT HAS I/O STALLED 

U.MEDI='B 1 

U.VCB+4 


;MEDIA IDENTIFIER (2 WORDS) 

; ALL THE 

FOLLOWING 

MSCP 

FIELDS APPLY ONLY TO DISK 

U.BPKT= 1 B' 

U.VCB+10 


;UNIT BAD BLOCK PACKET WAITING LIST 


CHARACTERISTICS OBTAINED FROM "GET UNIT STATUS" END PACKETS 


U.MLUN='B' 

U.VCB+14 

;MULTI 

-UNIT CODE 

U.UNFL='B' 

U.VCB+16 

; UNIT 

FLAGS 

U.UNTI='B' 

U.VCB+24 

;UNIT 

IDENTIFIER 

U.2MED='B' 

U.VCB+34 

;ORIGINAL COPY OF MEDIA IDENTIFIER 

U.SHUN='B' 

U.VCB+40 

;SHADOW UNIT 

U.SHST='B' 

U.VCB+42 

;SHADOW UNIT STATUS 

U.TRCK='B' 

U.VCB+44 

;UNIT 

TRACK SIZE 

U.GRP='B' 

U.VCB+46 

; UNIT 

GROUP SIZE 

U.CYL='B' 

U.VCB+50 

;UNIT 

CYLINDER SIZE 

U.USVR='B' 

U.VCB+52 

;UNIT 

SOFTWARE VERSION 

U.UHVR= 1 B' 

U.VCB+53 

; UNIT 

HARDWARE VERSION 

U.RCTS='B' 

U.VCB+54 

;UNIT 

RCT TABLE SIZE 

U.RBNS='B 1 

U.VCB+56 

; UNIT 

RBN 'S / TRACK 

U.RCTC='B' 

U.VCB+57 

; UNIT 

RCT COPIES 
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CHARACTERISTICS OBTAINED FROM "ONLINE" OR "SET UNIT CHARACTERISTICS" 
END PACKETS 


U.UNSZ=' B 1 U.VCB+60 
U.VSER='B ' U.VCB+64 


TERMINAL DRIVER DEFINITIONS 


.=U.BUF 


;UNIT SIZE 

;VOLUME SERIAL NUMBER 


U.TUX:'L' 

.BLKW 

1 

;POINTER TO UCB EXTENSION (UCBX) 

U.TSTA:'L' 

.BLKW 

4 

;STATUS QUADRUPLE-WORD 

U.TFRQ:’L' 

.BLKW 

1 

;FORK REQUEST WORD 

U.TFLK:'L' 

.BLKW 

1 

;FORK LIST LINK WORD 

U.TCHP:'L' 

.BLKB 

1 

;CURRENT HORIZONTAL POSITION 

U.TCVP:'L' 

.BLKB 

1 

;CURRENT VERTICAL POSITION 

U.UIC:'L' 

.BLKW 

1 

/•TERMINAL UIC 

U.TTYP:'L' 

.BLKB 

1 

;TERMINAL TYPE 

U.TMTI:'L' 

.BLKB 

1 

;MODEM TIMER 

U.TTAB:'L' 

.BLKW 

1 

;IF 0: U.TTAB+1 IS SINGLE-CHARACTER 


U.CTYP:'L' 
U.TLPP:'L' 
U.TST5: 'L' 
U.TST6:'L' 
U.TIXL:'L' 
U.ACB:’L' 
U.AFLG:'L' 
U.ADMA:'L' 


. BLKB 
.BLKB 
.BLKW 
• BLKW 
.BLKW 
.BLKW 
.BLKW 
.BLKW 


TYPE-AHEAD BUFFER, CURRENTLY EMPTY 
IF ODD: U.TTAB+1 IS SINGLE-CHARACTER 
TYPE-AHEAD BUFFER AND HOLDS A 
CHARACTER 

IF NON-O AND EVEN: POINTER TO 
MULTI-CHARACTER TYPE-AHEAD BUFFER 
CONTROLLER TYPE 
LINES PER PAGE 
ADDITIONAL STATUS BITS 
EXTENDED I/O STATUS BITS 
I/O PACKET EXTENSION LISTHEAD 
ANCILLARY CONTROL DRIVER BLOCK ADDR 
ANCILLARY CONTROL DRIVER FLAGS WORD 
ANCILLARY CONTROL DRIVER DMA BUFFER 


CONSOLE DRIVER DEFINITIONS 


.=U.BUF+2 

U.CTCB:'L 1 .BLKW 1 
U.COTQ:'L' .BLKW 2 
U.RED2:'L' .BLKW 1 


;ADDRESS OF CONSOLE LOGGER TCB 
;I/0 PACKET LIST QUEUE 
;REDIRECT UCB ADDRESS 


DEFINE BITS IN STATUS WORD 1 (U.TSTA) 


INPUT 


STATUS 


SI.RST= 1 B' 

SI.ESC='B' 
SI.RSP= 1 B' 
SI.PTH='B' 
S1.RNE='B' 
S1.TSY='B' 


2 

4 

10 

20 

40 


;READ WITH SPECIAL TERMINATORS IN 
;PROGRESS 

;ESCAPE SEQUENCE IN PROGRESS 
;READ WITH SPECIAL PROCESSING 
;PASS THRU IS CURRENTLY ACTIVE 
;ECHO SUPPRESSED 

;TERMINAL OUTPUT SYNC IS CURRENTLY 
; ENABLED 
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S1.0BY='B' 

100 

SI.IBY='B' 

200 

S1.DPR='B' 

400 

SI.DEC='B 1 

1000 

SI.IBF='B' 

2000 

SI.DSI='B' 

4000 

S1.RES='B’ 

10000 

S1.RNF='B' 

20000 

S1.TNE='B' 

40000 

SI.USI='B' 

100000 

; DEFINE BITS IN ! 

; OUT 

PUT 

} 

S2.RCU='B' 

1 

S2.WRA='B’ 

6 

S2.WRB='B' 

2 

S2.WAL='B' 

10 

S2.BRQ='B' 

20 

S 2.SRQ='B' 

40 

S2.0RQ='B' 

100 

S2.IRQ='B' 

200 

S 2.FLF='B' 

400 

S2.ELF='B' 

1000 

S2.CR='B' 

2000 

S2.0BF='B' 

4000 

S2.PCU='B' 

10000 

S2.BEL='B' 

20000 

S2.CTO='B' 

40000 

S2.CTS='B' 

100000 


OUTPUT BUSY 
INPUT BUSY 

DEFER PROCESSING OF CHAR. IN U.TECB 

DEFER ECHO OF CHAR. IN U.TECB 

BUFFERED INPUT IN PROGRESS 

INPUT PROCESSING DISABLED 

ESC. SEQ PROCESSING IS ENABLED FOR THE 

CURRENT READ 

READ NO FILTER IS ACTIVE (EDIT CHARS. 
ARE DISPLAYED) 

TERMINATOR NO ECHO 
UNSOLICITED INPUT IN PROGRESS 


2 (U.TSTA+2) 


STATUS 


RESTORE CURSOR (MUST = TF.RCU) 

CONTEXT FOR WRAP-AROUND 

LOW BIT IN S2.WRA BIT PATTERN 

WRITE PASS ALL (MUST = TF.WAL) 

BREAK-THROUGH-WRITE REQUEST IN QUEUE 

SPECIAL REQUEST IN QUEUE 

(10.ATT, IO.DET, SF.SMC) 

OUTPUT REQUEST IN QUEUE (MUST = Sl.OBY) 

INPUT REQUEST IN QUEUE (MUST = Sl.IBY) 

FORCE LINEFEED BEFORE NEXT ECHO 

EAT A LINEFEED (IGNORE A LEADING LF ON 

OUTPUT) 

TRAILING CR REQUIRED ON OUTPUT 
BUFFERED OUTPUT IN PROGRESS 
POSITION CURSOR BEFORE WRITE 
BELL PENDING 

OUTPUT STOPPED BY CTRL-0 266. 

OUTPUT STOPPED BY CTRL-S 


DEFINE BITS IN STATUS WORD 3 (U.TSTA+4) 


TERMINAL OPERATION CHARACTERISTICS 


S3.ACR= 
S3.TAB= 
S3.CTC= 
S 3.RAL = 
S3•NEC= 
S3.TSY= 
S3.8BC= 
S 3.FDX = 
S3.MHE= 
S3.ICE= 
S3.TME= 
S3. PTH = 
S3.RES= 
S3.PPT= 
S3.RUB= 


*B 1 
'B* 
1 B 1 
'B' 
'B ' 
*B 1 
'B* 
*B 1 
*B 1 
'B' 
1 B ' 
1 B 1 
*B 1 
1 B 1 
'B 1 


1 

2 

4 

10 

20 

40 

100 

200 

400 

1000 

2000 

4000 

10000 

20000 

40000 


WRAP-AROUND (AUTOMATIC CR-LF) REQUIRED 

TYPE-AHEAD BUFFER ALLOCATION REQUESTED 

TERMINAL WANTS CLI TO HAVE ~C NOTIFICATION 

TERMINAL IS IN READ-PASS-ALL MODE 

NO ECHO 

TERMINAL SYNC 

PASS 8 BITS ON INPUT 

LINE IS IN FULL DUPLEX MODE 

NOTIFY ATTACHED TASK OF MODEM HANG-UP 

INPUT COUNT STATE ENABLED 

TERMINAL MANAGEMENT MODE ENABLED 

PASS THROUGH REQUESTED 

TASK WANTS ESCAPE SEQUENCES 

TERMINAL HAS PRINTER PORT 

RUBOUT SEQUENCE IN PROGRESS (NON-SCOPE) 
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DEFINE BITS IN STATUS WORD 4 (U.TSTA+6) 


; TERMINAL 

ATTRIBUTE 

CHARACTERISTICS 

S4.HFL='B' 

7 

HORIZONTAL FILL REQUIREMENT 

S4.VFL='B' 

10 

;VERTICAL FILL REQUIREMENT 

S4.HFF='B' 

20 

HARDWARE FORM-FEED PRESENT 

S 4.HHT='B' 

40 

HARDWARE HORIZONTAL TAB PRESENT 

S4.DLO='B' 

100 

;DIAL-OUT LINE (IMPLIES U2.RMT) 

S4.HSY='B' 

200 

HOST/TERMINAL SYNCHRONIZATION ENABLED 
/(1=YES) 

S4.ANI='B 1 

400 

;ANSI CRT TERMINAL 

S4.AVO='B' 

1000 

;VT100-FAMILY TERMINAL DISPLAY 

S4.BLK='B' 

2000 

/BLOCK MODE TERMINAL 

S4.DEC='B' 

4000 

;DIGITAL CRT TERMINAL 

S4.EDT='B' 

10000 

/TERMINAL HAS LOCAL EDITING FUNCTIONS 

S4.RGS='B' 

20000 

/TERMINAL SUPPORTS REGIS GRAPHICS 

S4.SFC='B' 

40000 

/TERMINAL SUPPORTS SOFT CHARACTERS (DRCS) 

S4.ABD='B' 

100000 

/AUTO-BAUD SPEED DETECTION ENABLED 


DEFINE BITS IN STATUS WORD U.TST5 
ADDITIONAL STATUS CHARACTERISTICS 


S5.SW1='B' 

1 

/FIRST TERMINAL MANAGEMENT SWITCH 
/CHARACTER HAS BEEN SEEN 

S5.TMM='B' 

2 

/TERMINAL IN TERMINAL MANAGEMENT MODE 

S5.XOF='B' 

4 

/SEND AN XOFF AT FIRST OPPORTUNITY 

S5.XON='B' 

10 

/SEND AN XON AT FIRST OPPORTUNITY 

S 5.H PC ='B' 

14 

/OUTPUT OF HIGH PRIORITY CHARACTERS 
/REQUESTED 

S5.HPO='B' 

20 

/HIGH PRIORITY OUTPUT IN PROGRESS 

S5.0XF='B' 

40 

/XOFF HAS BEEN OUTPUT 

S5.ITI='B' 

100 

/IMMEDIATE TIMEOUT ON INPUT 

S5.RPO=’B' 

2000 

/READ W/PROMPT OUTPUT IN PROGRESS 

S5.VER='B' 

10000 

/LAST CHAR. IN TYPE-AHEAD BUFFER 
/HAS PARITY ERROR 

S5.BCC='B' 

20000 

/LAST CHAR. IN TYPE-AHEAD BUFFER 
/HAS FRAMING ERROR 

S 5.DAO='B' 

40000 

/LAST CHAR. IN TYPE-AHEAD BUFFER 
/HAS DATA OVERRUN ERROR 

/NOTE - THE 3 BITS ABOVE MUST CORRESPOND 
/TO THE RESPECTIVE ERROR FLAGS IN THE 
/HARDWARE RECEIVE BUFFER 

S5.ABP='B' 

/ 

100000 

/AUTO-BAUD SPEED DETECTION IN PROGRESS 

f 

/ DEFINE BITS IN EXTENDED 
/ 

I/O STATUS WORD U.TST6 

} 

S6.EIO=’B' 

400 

/READ WAS AN EXTENDED I/O 

S 6.RLU='B' 

1000 

/READ WITH LOWER CASE TO UPPER CASE 
/CONVERSION 

S6.RDI='B' 

100000 

/READ WITH DEFAULT INPUT 
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.PSECT 


DEVICE TABLE STATUS DEFINITIONS 

DEVICE CHARACTERISTICS WORD 1 (U.CWl) DEVICE TYPE DEFINITION BITS. 


DV.REC='B' 

1 

DV.CCL='B' 

2 

DV.TTY='B' 

4 

DV.DIR='B' 

10 

DV.SDI='B' 

20 

DV.SQD='B' 

40 

DV.MSD='B' 

100 

DV.UMD='B' 

200 

DV.MBC='B' 

400 

DV.EXT='B' 

400 

DV.SWL='B 1 

1000 

DV.ISP='B' 

2000 

DV.OSP= 1 B' 

4000 

DV. PSE='B' 

10000 

DV.COM='B' 

20000 

DV.F11='B' 

40000 

DV.MNT='B' 

100000 


RECORD ORIENTED DEVICE (1=YES) 

CARRIAGE CONTROL DEVICE (1=YES) 

TERMINAL DEVICE (1=YES) 

FILE STRUCTURED DEVICE (1=YES) 

SINGLE DIRECTORY DEVICE (1=YES) 

SEQUENTIAL DEVICE (1=YES) 

MASS STORAGE DEVICE (1=YES) 

USER MODE DIAGNOSTICS SUPPORTED (1=YES) 
DEVICE IS ON MASSBUS CONTROLLER (1=YES) 
DEVICE ON EXTENDED ADDRESSING CONTROLLER 
UNIT SOFTWARE WRITE LOCKED (1=YES) 

INPUT SPOOLED DEVICE (1=YES) 

OUTPUT SPOOLED DEVICE (1=YES) 

PSEUDO DEVICE (1=YES) 

DEVICE IS MOUNTABLE AS COM CHANNEL 
(1=YES) 

DEVICE IS MOUNTABLE AS Fll DEVICE (1=YES) 
DEVICE IS MOUNTABLE (1=YES) 


+ 

TERMINAL DEPENDENT CHARACTERISTICS WORD 2 (U.CW2) BIT DEFINITIONS 


U2.DH1='B' 100000 
U2.DJ1=’B' 40000 
U2.RMT='B' 20000 
U2.HFF='B' 10000 
U2.L8S='B' 10000 


U2.NEC='B' 4000 
U2.CRT='B' 2000 
U2.ESC='B' 1000 
U2.LOG='B' 400 
U2.SLV='B' 200 
U2.DZ1='B' 100 
U2.HLD='B' 40 
U2.AT.='B' 20 
U2.PRV='B' 10 
U2.L3S='B' 4 
U2.SCS='B' 4 
U2.VT5='B' 2 
U2.LWC= 1 B' 1 


UNIT IS A MULTIPLEXER (1=YES) 

UNIT IS A DJll (1=YES) 

UNIT IS REMOTE (1=YES) 

UNIT HANDLES HARDWARE FORM FEEDS (1=YES) 
OLD NAME FOR U2.HFF 

DON'T ECHO SOLICITED INPUT (1=YES) 

UNIT IS A CRT (1=YES) 

UNIT GENERATES ESCAPE SEQUENCES (1=YES) 
USER LOGGED ON TERMINAL (0=YES) 

UNIT IS A SLAVE TERMINAL (1=YES) 

UNIT IS A DZ11 (1=YES) 

TERMINAL IS IN HOLD SCREEN MODE (1=YES) 
MCR COMMAND AT. BEING PROCESSED (1=YES) 
UNIT IS A PRIVILEGED TERMINAL (1=YES) 
UNIT IS A LA30S TERMINAL (1=YES) 

SCS-11 COMMAND TERMINAL (1=YES) 

UNIT IS A VT05B TERMINAL (1=YES) 

LOWER CASE TO UPPER CASE CONVERSION 
(0=YES) 


+ 

BIT DEFINITIONS FOR U.MUP (SYSTEMS WITH ALTERNATE CLI SUPPORT ONLY) 
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UM.OVR='B' 

1 

;OVERRIDE CLI INDICATOR 

UM.CLI='B' 

36 

;CLI INDICATOR BITS 

UM.DSB='B' 

200 

/TERMINAL DISABLED SINCE CLI ELIMINATED 

UM.NBR='B' 

400 

;NO BROADCAST 

; + 

; RH11-RS03/RS04 CHARACTERISTICS WORD 2 (U.CW2) BIT DEFINITIONS 

U2.R04= 1 B * 

100000 

/UNIT IS A RS04 (1=YES.) 


+ 

RH11-TU16 CHARACTERISTICS WORD 2 (U.CW2) BIT DEFINITIONS 


U2.7CH='B' 10000 
+ 


;UNIT IS A 7 CHANNEL DRIVE (1=YES) 
TERMINAL DEPENDENT CHARACTERISTICS WORD 3 (U.CW3) BIT DEFINITIONS 


U3.UPC='B' 20000 
U3.PAR='B' 40000' 
U3.OPA='B' 100000 


/UPCASE OUTPUT FLAG 
/PARITY GENERATION AND CHECKING 
;PARITY SENSE (l=ODD PARITY) 


TERMINAL DEPENDENT CHARACTERISTICS WORD 4 (U.CW4) BIT DEFINITIONS 


U4.CR=’B' 100 
+ 


;LOOK FOR CARRIAGE RETURN 
UNIT CONTROL PROCESSING FLAG DEFINITIONS 


UC.ALG='B' 

200 

UC.NPR='B' 

100 

UC.QUE='B 1 

40 

UC.PWF='B' 

20 

UC.ATT='B' 

10 

UC.KIL='B' 

4 

UC.LGH='B' 

3 


+ 

UNIT STATUS BIT DEFINTIONS 


US.BSY='B' 

200 

US.MNT='B' 

100 

US.FOR='B' 

40 

US.MDM='B' 

20 

US.PWF='B' 

10 


;BYTE ALIGNMENT ALLOWED (l=NO) 

;DEVICE IS AN NPR DEVICE (1=YES) 

;CALL DRIVER BEFORE QUEUING (1=YES) 

;CALL DRIVER AT POWERFAIL ALWAYS (1=YES) 
;CALL DRIVER ON ATTACH/DETACH (1=YES) 
;CALL DRIVER AT I/O KILL ALWAYS (1=YES) 
;TRANSFER LENGTH MASK BITS 


;UNIT IS BUSY (1=YES) 

;UNIT IS MOUNTED (0=YES) 

;UNIT IS MOUNTED AS FOREIGN VOLUME (1=YES) 
;UNIT IS MARKED FOR DISMOUNT (1=YES) 

;POWERFAIL OCCURRED (1=YES) 


+ 

CARD READER DEPENDENT UNIT STATUS BIT DEFINITIONS 


US.ABO='B' 1 
US,MDE='B' 2 


/UNIT IS MARKED FOR ABORT IF NOT READY 
/(1=YES) 

;UNIT IS IN 029 TRANSLATION NODE (1=YES) 


B-51 












RSX-11M SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS 


UCBDF$ (Cont.) 


+ 

FILES-11 DEPENDENT UNIT STATUS BITS 


US.WCK='B' 10 
US.SPU='B' 2 

US. VV= 1 B' 1 

; + 

: KMC-ll-LP DEPDENDENT UNIT 


US•KPF= 1 B' 1 


;WRITE CHECK ENABLED (1=YES) 
;UNIT IS SPINNING UP (1=YES) 

; VOLUME VALID IS SET (1=YES) 


STATUS BITS 


;KMC-11 POWERFAIL INTERLOCK 


+ 

TERMINAL DEPENDENT UNIT STATUS BIT DEFINITIONS 


.IF NB TTDEF 
.IF DF T$$CPW 


US.CRW='B' 4 
US.DSB='B' 2 
US.OIU='B' 1 


.IFF 

US.DSB='B' 10 
US.CRW='B' 4 
US.ECH='B 1 2 
US.OUT='B' 1 


;UNIT IS WAITING FOR CARRIER (1=YES) 
;UNIT IS DISABLED (1=YES) 

;OUTPUT INTERRUPT IS UNEXPECTED ON UNIT 
;(1=YES) 

; T $ $C PW 

;UNIT IS DISABLED (1=YES) 

;UNIT IS WAITING FOR CARRIER (1=YES) 
;UNIT HAS ECHO IN PROGRESS (1=YES) 

;UNIT IS EXPECTING OUTPUT INTERRUPT 
; (1=YES) 


. ENDC 

. ENDC ;TTDEF 


+ 

LPS11 DEPENDENT UNIT STATUS BIT DEFINITIONS 


US . FRK= ' B ' .2 
US.SHR='B 1 1 

; + 

; MAGTAPE DEPENDENT UNIT STATUS BITS 

US.LAB='B' 4 J UNIT HAS LABELED TAPE ON IT (1=YES) 

US.BSP='B 1 2 ; INTERNAL BACKSPACE IN PROGRESS (1=YES) 

; + 

; UNIT STATUS EXTENSION (U.ST2) BIT DEFINITIONS 


;FORK IN PROGRESS (1=YES) 

;SHAREABLE FUNCTION IN PROGRESS (0='B'YES) 
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UCBDF$ (Cont.) 


US.OFL= 1 B' 1 
US.RED='B' 2 
US.PUB='B' 4 
US.UMD='B 1 10 


;UNIT OFFLINE (1=YES) 

;UNIT REDIRECTABLE (0=YES) 
;UNIT IS PUBLIC DEVICE (1=YES) 
;UNIT ATTACHED FOR DIAGNOSTICS 


(1=YES) 


; + 

; MAG TAPE DENS SUPPORT 
; ASSIGNMENTS PER 


IDENT IN CHAR WORD 3 (U.CW3) DEFENITION 
NUMERICAL SEQUENCE 0 - 255. 


UD.UNS='B' 0 
UD.200='B 1 1 
UD.556='B 1 2 
UD.800='B' 3 
UD.160='B' 4 
UD.625='B 1 5 
UD.8K='B' 6 


UNSUPPORTED 


200BPI, 
556BPI, 
800BPI, 
1600BPI, 
6250BPI, 
8K BPI - 


TRACK 

TRACK 

OR 9 TRACK 

TRACK 

TRACK 


SERIAL, SERPENTINE RECORDING 


.MACRO' UCBDF$,X,Y,Z,ZZ 
. ENDM 
. ENDM 
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APPENDIX C 


RSX-11M-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC 


D 


EFINITIONS 


This appendix describes the RSX-11M-PLUS system macros that supply 
symbolic offsets for data structures listed in Table C-l. 


The data structures are defined by macros in the 
library. To reference any of the data structure o 
code, include the macro name in an .MCALL directive 
macro. For example: 


Executive macro 
ffsets from your 
and invoke the 


.MCALL DCBDF$ 

DCBDF$ ;Define DBC offsets 


NOTE 

All physical offsets and bit definitions are subject 
to change in future releases of the operating system. 
Code that accesses system data structures should 
always use the symbolic offsets rather than the 
physical offsets. 


The first two arguments, <:> and <=>, make all definitions global. If 
they are left blank, the definitions will be local. 

All of these macros are in the Executive macro library 
LB: [1,1]EXEMC•MLB• All except FllDF$, ITBDF$, MTADF$, OLRDF$, and 
SHDDF$ are also in the Executive definition library 
LB: [1,1]EXELIB•OLB. 


ABODF$ 


Table C-l 

Summary of System Data Structure Macros 


Macro Arguments Data Structures 


<:>,<=> Task abort and termination 

notification message codes 


ACNDF$ <:>,<=> 


CLKDF$ <:>,<=> 


Accounting data structures (user 
account block, task account 
block, system account block) 

Clock queue control block 


CTBDF$ <:>,<=> 


Controller table 


(Continued on next page) 
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Table C-l (Cont.) 

Summary of System Data Structure Macros 


Macro Arguments 

Data Structures 

DCBDF$ 

<:>,<=> 

Device Control Block 

EPKDF$ 

<:>,<=> 

Error message block 

EVNDF$ 

<:>,<=> 

Terminal Software Architecture 

(TSA) event packet definitions 

F11DF$ 

<:>,<=> 

FILES-11 data structures (Volume 
Control Block, mount list entry. 
File Control Block, file window 
block, locked block list node) 

HDRDF$ 

<:>,<=> 

Task header and window block 

HWDDF$ 

<:>,<=> 

Hardware register addresses and 
feature mask definitions 

ITBDF$ 

<:>,<=> 

Interrupt transfer block 

KRBDF$ 

<:>,<=> 

Controller request block 

LCBDF$ 

<:>,<=> 

Logical assignment control block 

MTADF$ 

<:>,<=> 

ANSI magtape data structures 

(volume set control block) 

OLRDF$ 


On-line reconfiguration interface 

PCBDF$ 

<:>,<=> 

Partition Control Block and 

attachment descriptor 

PKTDF$ 

<:>,<=> 

I/O packet, AST control block, 
offspring control block, group 
global event flag control block, 
and CLI parser block 

SCBDF$ 

<:>,<=> 

Status Control Block and UMR 

assignment block 

SHDDF$ 

<:>,<=> 

Shadow recording linkage block 

TCBDF$ 

<:>,<=> 

Task Control Block 

UCBDF$ 

<:>,<=>,TTDEF 

Unit Control Block 
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ABODF$ 


.MACRO ABODF$,L,B 


TASK ABORT CODES 

NOTE: S.COAD-S.CFLT ARE ALSO SST VECTOR OFFSETS 


S.CACT=’B'-4. 

S.CEXT='B'-2. 

S.COAD='B'0. 

S.CSGF='B'2. 

S.CBPT='B'4. 

S.CIOT='B'6. 

S.CILI='B'8. 

S.CEMT='B'10. 

S.CTRP='B'12. 

S.CFLT='B'14. 

S.CSST='B'16. 

S.CAST='B'18. 

S.CABO='B'20. 

S.CLRF='B'22. 

S.CCRF='B'24. 

S.IOMG='B 1 26. 

S.PRTY='B'28. 

S.CPMD='B'30. 

S.CELV='B'32. 

S.CINS='B'34. 

S.CAFF=’B'36. 

S.CCSM='B'38. 

S.COTL='B'40. 

S.CTKN='B'42. 


TASK STILL ACTIVE 

TASK EXITED NORMALLY 

ODD ADDRESS AND TRAPS TO 4 

SEGMENT FAULT 

BREAK POINT OR TRACE TRAP 

IOT INSTRUCTION 

ILLEGAL OR RESERVED INSTRUCTION 

NON RSX EMT INSTRUCTION 

TRAP INSTRUCTION 

11/40 FLOATING POINT EXCEPTION 

SST ABORT-BAD STACK 

AST ABORT-BAD STACK 

ABORT VIA DIRECTIVE 

TASK LOAD REQUEST FAILURE 

TASK CHECKPOINT READ FAILURE 

TASK EXIT WITH OUTSTANDING I/O 

TASK MEMORY PARITY ERROR 

TASK ABORTED WITH PMD REQUEST 

TI: VIRTUAL TERMINAL WAS ELIMINATED 

TASK INSTALLED IN 2 DIFFERENT SYSTEMS 

TASK ABORTED DUE TO BAD AFFINITY (REQUIRED 

BUS RUNS ARE OFFLINE OR NOT PRESENT) 

BAD CSM PARAMETERS OR BAD STACK 

TASK HAS RUN OVER ITS TIME LIMIT 

ABORT VIA DIRECTIVE WITH NO TKTN MESSAGE 


TERMINATION CODES FOR BOM$ 

NOTE: 

THE NORMAL TKTN ERROR CODES SPAN -4 THROUGH 42. THE BOM CODES, 
ALTHOUGH DEFINED FOR THE TASK, ETC, AS 0 THROUGH N, ARE PASSED TO 
TKTN AS -127 THROUGH -127+N. AN UNRECOGNIZED CODE IS PASSED AS -128, 
UNKNOWN ERROR. 


S.BUNK='B'-128. 

S.BFEI='B'0. 

S.BOVL='B'l. 


;UNKNOWN BOM$ ERROR 

;ERROR IN HIGH LEVEL LANGUAGE INTERFACE 
;LOAD OVERLAY FAILURE 


KEEP THE FOLLOWING DEFINED AS THE HIGHEST CODE IN USE 


S.BHI='B'1. 


;HIGHEST ACCEPTABLE BOM$ CODE 


; BIT DEFINITIONS FOR BOM$ FLAGS WORD 

S.BBIF='B'l. ;ENABLE CONDITIONAL BREAKPOINT 
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ABODF$ (Cont.) 


f 

; TASK TERMINATION 

r 

NOTIFICATION MESSAGE CODES 

T.NDNR='B'0 

;DEVICE NOT READY 

T.NDSE='B'2 

;DEVICE SELECT ERROR 

T.NCWF='B'4 

CHECKPOINT WRITE FAILURE 

T.NCRE='B'6 

;CARD READER HARDWARE ERROR 

T.NDMO='B'8. 

;DISMOUNT COMPLETE 

T.NUER='B'10. 

;UNRECOVERABLE ERROR 

T.NLDN='B'12. 

;LINK DOWN (NETWORKS) 

T.NLUP='B'14. 

;LINK UP (NETWORKS) 

T.NCFI = 'B'16 . 

CHECKPOINT FILE INACTIVE 

T.NUDE='B'18. 

;UNRECOVERABLE DEVICE ERROR 

T.NMPE='B'20. 

;MEMORY PARITY ERROR 

T.NKLF='B'22. 

;UCODE LOADER NOT INSTALLED 

T.NAAF='B'24. 

;ACCOUNTING ALLOCATION FAILURE 

T.NTAF='B'26. 

;ACCOUNTING TAB ALLOCATION FAILURE 

T.NDEB='B'28. 

;TASK HAS NO DEBUGGING AID 

T.NRCT='B'30. 

;REPLACEMENT CONTROL TASK NOT INSTALLED 

T.NWBL='B'32. 

;WRITE BACK CACHING DATA LOST 
;UNIT WRITE LOCKED 

T.NVER='B'34. 

;MOUNT VERIFICATION TASK NOT INSTALLED 

T . NI OS = ' B ' 3 6 . 

;I/O STALLED TO DEVICE 

T.NIOR='B'38. 

;I/O RESUMING ON DEVICE 


.MACRO 
• ENDM 
. ENDM 


ABODF$ X,Y 
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ACNDF$ 


•MACRO ACNDF$,L,B 


ACCOUNTING BLOCK OFFSET AND STATUS DEFINITIONS 
FOR EACH TRANSACTION TYPE. 

HEADER COMMON TO ALL TRANSACTIONS 


•ASECT 


B.LNK:'L'.BLKW 

1 


;LINK TO NEXT IN SYSLOG QU 

EUE 

B.TYP:'L'.BLKB 

1 


;TRANSACTION TYPE 


B.LEN:'L'.BLKB 

1 


TRANSACTION LENGTH 


B.TIM:'L'.BLKW 

3 


;ENDING TIME OF TRANSACTIO 

'N 

B.HID='B ' . 



;START OF HEADER IDENTIFIC 

ATION AREA 

B.UID:'L'.BLKW 

2 


;UNIQUE SESSION IDENT 





; FIRST WORD-RAD50, SECOND 

-BINARY 

B.ACN:'L'.BLKW 

1 


/ACCOUNT NUMBER 


B.TID:'L'.BLKB 

1 


/ASCII TERMINAL TYPE (V,T, 

B OR C) 




/(VIRTUAL,REAL,BATCH, OR C 

ONSOLE) 

.BLKB 

1 


/UNIT NUMBER 


B.HEND='B'. 



/END OF HEADER ID AREA 


$$$HLN=. 



/HEADER LENGTH 


; + 

; ACCUMULATION 

FIELDS 

FOR 

TAB, UAB, AND SAB 


B.CPU:'L'.BLKW 

2 


/TOTAL CPU TIME USED 


B.DIR:'L'.BLKW 

2 


/TOTAL DIRECTIVE COUNT 


B.QIO:'L'.BLKW 

2 


/TOTAL QIO$ COUNT 


B.TAS:'L'.BLKW 

2 


/TOTAL TASK COUNT 


B.MEM:'L'.BLKW 

3 


/RESERVED 


B.BEG:'L'.BLKW 

3 


/BEGINNING/LOGIN TIME 


B.CPUL:'L'.BLKW 

2 


/CPU LIMIT 


B.PNT:'L'.BLKW 

1 


/POINTER TO HIGHER LEVEL T 

OTALS 

B.STM:'L'.BLKB 

1 


/STATUS MASK 

. 

$$$TLN=. 



/TOTAL'S LENGTH 


; + 

; USER ACCOUNT 

BLOCK 

(UAB) 



; NOTE: 

UAB 1 S 

MUST 

END ON A WORD BOUNDRY 


. =$$$TLN 



/START AFTER TOTALS 


B.USE:'L'.BLKB 

1 


/USE COUNT 


B.ACT:'L'.BLKW 

1 


/NUMBER OF CURRENTLY ACTIV 

E TASKS 

B.UUIC:'L'.BLKW 

1 


/LOGIN UIC 


B.UCB:'L'.BLKW 

1 


/POINTER TO UCB 


B.LGO:'L'.BLKW 

3 


/LOGOFF TIME 


B.ULNK:'L'.BLKW 

1 


/LINK TO NEXT UAB 


B.RNA:'L'.BLKW 

3 


/LOC IN SYSTEM ACCNT FILE 



;(OFFSET,VBN-HI,VBN-LO) 
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ACNDF$ (Cont.) 


B.NAM:'L'.BLKB 

14. 

;LAST NAME OF USER 


.BLKB 

1 

;FIRST INITIAL OF USER 


.BLKB 

1 

;FLAG BYTE FOR UAB (bs.sil) 

etc. 

B.LDS:'L'.BLKB 

10. 

;LOGIN DIRECTORY STRING 


B.ULEN='B'. 


;UAB LENGTH 


$$$= <.+77>/100 

;UAB LENGTH (ROUNDED UP TO 

32 WORD BOUND) 


+ 

TASK ACCOUNT BLOCK (TAB) 

NOTE: THE TAB MUST END ON A WORD BOUNDARY 


r ~ 

.=$$$TLN 



;STARTS AFTER TOTALS 

B.PRI:'L'. 

BLKB 

1 

;HIGHEST RUNNING PRIORITY 

B.TNAM:'L' 

• BLKW 

2 

;TASK NAME 

B.TCB:'L' 

.BLKW 

1 

;TCB ADDRESS 

B.TST3:'L' 

.BLKW 

1 

;T . ST3 FROM TASK'S TCB 


.BLKW 

1 

;RESERVED FOR FUTURE STATUS BITS 

B.CUIC:'L' 

.BLKW 

1 

;CURRENT UIC OF TASK 

B.PUIC:'L' 

.BLKW 

1 

; PROTECTION UIC OF TASK 

B.CTXT:'L' 

.BLKW 

2 

; NUMBER OF CONTEXT LOADS 

B.TCKP:'L' 

.BLKW 

2 

;TIMES TASK HAS BEEN CHECKPOINTED 

B . OVLY : 'L' 

.BLKW 

2 

; NUMBER OF DISK OVERLAY LOADS 

B.EXST:'L' 

.BLKW 

2 

;EXIT STATUS AND ABORT CODE 

B.TLEN='B' 

# 


;TAB LENGTH 

B.TBLK='B' 

<.+77>/100 

;NUMBER OF SEC POOL BLOCKS IN TAB 


+ 

SYSTEM ACCOUNT BLOCK (SAB) 


. =$$$TLN 

B.SHDN:'L'.BLKB 

1 

;START AFTER TOTALS 
;ACCOUNTING SHUTDOWN REASON CODE 

B.UHD:'L'.BLKW 

1 

;UAB LISTHEAD 

B.ULO:'L'.BLKW 

1 

;NUMBER OF USERS CURRENTLY LOGGED ON 

B.ULT:'L'.BLKW 

2 

;TOTAL NUMBER OF LOGONS 

B.CKP:'L'.BLKW 

2 

;TOTAL NUMBER OF CHECKPOINTS 

B.SHF:'L'.BLKW 

2 

;TOTAL NUMBER OF SHUFFLER RUNS 

B.RND:'L'.BLKW 

2 

;NUMBER OF CPU INTERVALS ROUNDED UP TO 1 

B.FID:'L'.BLKW 

3 

;FILE-ID OF TRANSACTION FILE 

B.DVNM:'L'.BLKB 

2 

;DEVICE OF TRANSACTION FILE 

B.UNIT:'L'.BLKW 

1 

;UNIT OF TRANSACTION FILE 

B.EXTS:'L'.BLKW 

1 

;EXTEND SIZE FOR TRANSACTION FILE 

B.LSCN:'L'.BLKW 

3 

;TIME OF LAST SCAN 

B.SCNR:'L'.BLKW 

1 

;SCAN RATE IN SECONDS 

B.DSCN:'L'.BLKW 

1 

;STATISTICAL SCAN RATE (IN SEC) 

B.STSP:'L'.BLKW 

2 

;RESERVED 

B.SYSM:'L'.BLKW 

1 

;RESERVED 

B.CKUS:'L'.BLKW 

3 

;RESERVED 

B.CKSP:'L'.BLKW 

2 

;RESERVED 

B.CKAL:'L'.BLKW 

1 

;RESERVED 

B.SLEN='B'. 


;SAB LENGTH 


; NEW FIELDS FOR EXTENDED ACCOUNTING 
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ACNDFS (Cont.) 


B.CPUT:'L' 
B.CTXP:'L' 
B.IDCT: 'L' 
B.QIOC:'L' 
B.MIOC:'L' 
B.AIOC:'L' 
B.IPSN:'L' 
B.IPRC:'L' 
B.CKEX:'L' 
B.CFCL:'L' 
B.CFRK:'L' 
B.TLOD:'L' 
B.RLOD:'L' 


.BLKW 8. 
.BLKW 8. 
.BLKW 8. 
.BLKW 8. 
.BLKW 8. 
.BLKW 8. 
.BLKW 8. 
.BLKW 8. 
.BLKW 2 
.BLKW 2 
.BLKW 2 
.BLKW 2 
.BLKW 2 
. BLKB 82 


B.SSBL=.-B.SLEN 
$$$= <.+77>/100 


;CPU TIME USED PER PROCESSOR 
;NUMBER OF CONTEXT SWITCHES (PER PROC) 

;NUMBER OF IDLE LOOP ENTRIES (PER PROC) 

;NUMBER OF I/O INITIATIONS (PER PROC) 
;MASS STORE I/O COMPLETIONS (PER PROC) 
;ALL I/O COMPLETIONS (PER PROC) 

;IP INTERRUPTS SENT (PER PROC) 

;IP INTERRUPTS RCVD (PER PROC) 

;CHECKPOINT DUE TO EXTEND TASKS 
;CALLS TO CFORK 
;CFORK FORKS 
;TASK LOADS 
;REGION LOADS 

;BUMP SIZE TO NEXT 32 WORD BLOCK 
;EXTRA LENGTH OF SYSTEM STATISTICS BLOCK 
;SAB LENGTH (ROUNDED UP TO 32 WORD BOUND) 


; SYSLOG STARTUP TRANSACTION 


.= $$$HLN 

B.SSLN='B' 

} + 

; CRASH RECOVERY TRANSACTION 


;START AFTER HEADER 
;TRANSACTION LENGTH 


.= $$$HLN 

B.CTLS:'L'.BLKW 3 
B.CSRT:'L'.BLKW 1 
B.CRSN:'L'.BLKB 60. 
B.CLEN='B'. 


t 

; INVALID LOGIN TRANSACTION 


;START AFTER STANDARD HEADER 
;TIME OF LAST SCAN BEFORE CRASH 
;SCAN RATE BEFORE CRASH 
;ASCII TEXT EXPLAINING CRASH 
;TRANSACTION LENGTH 


.= $$$HLN 

B.INAM:'L'.BLKB 14. 
B.IUIC:'L'.BLKB 6. 

B.IPSW:'L'.BLKB 6. 
B.ILEN='B'. 


/ 

;NAME FROM LOGIN LINE 
;UIC FROM LOGIN LINE 
;PASSWORD FROM LOGIN LINE 
;TRANSACTION LENGTH 


r 

; DEVICE TRANSACTIONS 


•= $$$HLN 

B.DNAM:'L'.BLKW 1 
B.DUNT:'L'.BLKB 1 
B.DLEN='B'. 

.BLKB 1 


(ALLOCATION, DEALLOCATION, MOUNT, AND DISMOUNT) 


;ASCII DEVICE NAME 
;OCTAL DEVICE UNIT NUMBER 
;TRANSACTION LENGTH FOR ALL, 
,* UNUSED BYTE 


DEA, 


AND DMO 
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ACNDF$ (Cont.) 


B.DLBL:'L'.BLEW 6 
B.DMST:'L'.BLEW 1 
B.DUIC:'L'.BLEW 1 
B.DVPR:'L'.BLEW 1 
B.DACP:'L'.BLEW 2 
B.MLEN='B'. 

; + 

; STATUS BITS FOR MOUNT STATUS 


;VOLUME LABEL 
;MOUNT STATUS BITS 
;OWNER UIC 

;VOLUME PROTECTION CODE 
;NAME OF ACP FOR DEVICE 
;LENGTH OF MOUNT TRANSACTION 


MASE (B.DMST) 


BM. SHR='B'1 
BM.NOS='B'2 
BM.SYS=’B'4 
BM.FOR='B'10 


;DEVICE IS MOUNTED SHARED 
;DEVICE IS MOUNTED NOSHARE 

;DEVICE IS MOUNTED FOR THE SYSTEM (PUBLIC) 
;DEVICE IS MOUNTED FOREIGN 


; SYSTEM TIME CHANGE TRANSACTION 



$$$HLN 

B . TOLD:'L'.BLEB 6 
B.TNEW:'L'.BLEB 6 
B.TMLN= 1 B'. 


OLD TIME (YR, MON, DAY, HR, MIN, SEC) 
NEW TIME (YR, MON, DAY, HR, MIN, SEC) 
TRANSACTION LENGTH 


F "*■ 

; PRINT DESPOOLER TRANSACTION 


.= $$$HLN 

B.PNAM:'L'.BLEW 3 
B.PPGS:'L'.BLEW 1 
B.PNFI:'L'.BLEW 1 
B.PFRM:'L'.BLEB 1 
B.PPRI:'L'.BLEB 1 
B.PDEV:'L'.BLEW 1 
B.PPUN:'L'.BLEB 1 
B.PLEN=’B'. 


;START AFTER HEADER 
;PRINT JOB NAME (RAD50) 

;PAGE COUNT 

;NUMBER OF FILES PRINTED 
;FORM NUMBER 
;PRINT PRIORITY 
;PRINT DEVICE NAME (ASCII) 
;UNIT NUMBER OF PRINT DEVICE 
TRANSACTION LENGTH 


; + 

; CARD READER SPOOLING TRANSACTION 


.= $$$HLN 

B.RNAM:'L'.BLEW 3 
B.RCDS:'L'.BLEW 1 
B.RDEV:'L'.BLEW 1 
B.RUNT:'L'.BLEB 1 
B.RSOP:'L'.BLEB 1 
B.RLEN='B'. 


;START AFTER HEADER 
;BATCH OR PRINT JOB NAME 
;NUMBER OF CARDS READ 
;READER DEVICE NAME (ASCII) 

;UNIT NUMBER OF READER DEVICE 
;SUBMIT OR PRINT (0=SUBMIT, 1=PRINT) 
TRANSACTION LENGTH 


F ^ 

; LOGIN TRANSACTION 
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ACNDF$ (Cont.) 



.= $$$HLN 

B.LUIC:'L'.BLKW 1 
B.LNAM:'L'.BLKB 14. 

.BLKB 1 
B.LLEN='B'. 


RESET TRANSACTION PARAMETERS 


;AFTER HEADER 
;FILE-ID OF OLD TRN. FILE 
;DEVICE OF OLD TRN. FILE 
;UNIT OF OLD TRN. FILE 
;FILE-ID OF NEW TRN. FILE 
;DEVICE OF NEW TRN. FILE 
;UNIT OF NEW TRN. FILE 
;EXT. SIZE FOR OLD TRN. FILE 
;EXT. SIZE FOR NEW TRN. FILE 
;OLD SCAN RATE IN SECONDS 
;NEW SCAN RATE IN SECONDS 
;OLD STATISTICAL SCAN RATE 
;NEW STATISTICAL SCAN RATE 


RESERVED FOR DEC USE 
RESERVED FOR CUSTOMER USE 


.=$$$HLN 


TRANSACTION TYPES 


B.OFID: 

'L'.BLKW 

B.ODNM: 

'L'.BLKB 

B.OUNT: 

'L'.BLKW 

B.NFID: 

'L'.BLKW 

B.NDNM: 

'L'.BLKB 

B.NUNT: 

'L'.BLKW 

B.OEXS: 

'L'.BLKW 

B.NEXS: 

'L'.BLKW 

B.OSCR: 

'L'.BLKW 

B.NSCR: 

'L'.BLKW 

B.ODSC: 

’L'.BLKW 

B.NDSC: 

'L'.BLKW 

B•RTLN= 

'B' . 

; + 



000 THRU 127 
128 THRU 255 


;START AFTER HEADER 
;LOGIN UIC 
;USER'S LAST NAME 
;AND FIRST INITIAL 
;TRANSACTION LENGTH 


BT.SAB 
BT.UAB 
BT.TAB 
BT.SS= 
BT.INV 
BT.TIM 
BT.ALL 
BT.DEA 
BT.MOU 
BT.DMO 
BT.PRT 
BT.DIR 


= 1 B ' 1 
= 1 B 1 2 
= 'B'3 
'B'll 
='B'12 
='B’13 
='B'14 
='B'15 
='B'16 
='B 1 17 
= 'B ' 20 
='B'21 


BT.VOL='B'22 


BT.LOG='B'23 
BT.CRH='B'24 
BT.DST='B'25 
BT.RTP='B'26 
BT.INP='B'27 


SYSTEM ACCOUNT BLOCK (SAB) 

USER ACCOUNT BLOCK (UAB) 

TASK ACCOUNT BLOCK (TAB) 

SYSLOG STARTUP TRANSACTION 
INVALID LOGIN TRANSACTION 
SYSTEM TIME CHANGE TRANSACTION 
ALLOCATE DEVICE TRANSACTION 
DEALLOCATE DEVICE TRANSACTION 
MOUNT DEVICE TRANSACTION 
DISMOUNT DEVICE TRANSACTION 
PRINT DESPOOLER TRANSACTION 
DISK ACCOUNTING BY DIRECTORY 
(UNSUPPORTED) 

DISK ACCOUNTING BY VOLUME 
(UNSUPPORTED) 

LOGIN TRANSACTION 
CRASH RECOVERY TRANSACTION 
DEVICE STATISTICS (UCB EXTENSION) 
RESET TRANSACTION PARAMETERS 
CARD READER SPOOLING TRANSACTION 


STATUS MASK BIT DEFINITIONS (B.STM) 
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RSX-11M-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS 


ACNDF$ (Cont.) 


BS.ACT='B'200 

BS.CRH='B'100 

BS.LGO='B'40 

BS.CO='B'40 

BS.TML='B'20 

BS.SIL='B'20 

BS.ZER='B'10 

BS.SCN='B’4 


/CONTROL BLOCK ACTIVE 

/RECORD FROM "TMP" FILE AFTER SYSTEM CRASH 
/LOGGED OFF WITH OUTSTANDING ACTIVITY (UAB) 
/TASK'S Tl: IS CO: (TAB ONLY) 

/TAB EXISTS ONLY FOR TIME LIMIT (TAB ONLY) 
/SILENT LOGIN/LOGOUT (UAB ONLY) 

/LAST CPU INTERVAL WAS OF LENGTH ZERO 
/TRANSACTION READY FOR WRITE TO SCAN FILE 


+ 

ACCOUNTING FEATURE MASK ($ACNFE) 


BF. DST='B'40000 
BF.WRT='B'2000 
BF.SCN='B 1 1000 
BF.SLR='B'400 
BF.ERR='B'200 
BF.STR='B'100 
BF.LSS='B'40 

BF.TRN='B'10 
BF.XTK='B'4 
BF.TSK='B'2 
BF.XAC='B'1 


SHUTDOWN CODES (B.SHDN) 


1 MAINTENANCE 

2 REBOOT 

3 SCHEDULEDJ3HUTDOWN 

4 ACCOUNTING SHUTDOWN BY TASK "SHUTUP" 

5 OTHER 


STATISTICAL SCAN RATE 

FORCE SYSLOG TO WRITE ITS BUFFER 

SCAN REQUESTED 

SYSLOG IS RUNNING (NOT STOPPED) 

ACCOUNTING STOPPED DUE TO FATAL ERROR 
ACCOUNTING IS STARTING UP / SHUTTING DOWN 
ACCUMULATE SYSTEM STATISTICS 
(POINT UAB TO SAB) 

OUTPUT TO TRANSACTION FILE 
CHECKPOINT REQUEST IS DUE TO EXTK$ 

TASK ACCOUNTING TURNED ON 
EXTENDED ACCOUNTING ASSEMBLED IN 


************************************************************************ 

t 

B.MAXL='B'128. /MAXIMUM TRANSACTION LENGTH 

B.MINL='B'$$$HLN /MINIMUM TRANSACTION LENGTH 

•A********************************************************************** 

/ 


.PSECT 

.MACRO 

ACNDF$ 

X » Y 


. ENDM 
. ENDM 

.MACRO 

ACTDF$, 

L,B 


.ASECT 

.=0 

A.GRP:'L' 

.BLKB 

3 

; GROUP CODE (ASCII) 

A.MBR:'L' 

. BLKB 

3 

; MEMBER CODE 

A.PSWD:'L' 

.BLKB 

6 

; PASSWORD 

A.LNM:'L' 

.BLKB 

14. 

; LAST NAME 

A.FNM:'L' 

.BLKB 

12. 

; FIRST NAME 

A.LDAT:'L' 

.BLKB 

6 

; DATE OF LAST LOGON 
; FORMAT = (DD/MM/YY HH:MM:SS) 
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ACNDF$ (Cont.) 


A.NLOG:'L' 

• BLKB 

2 

A.SYDV:'L' 

• BLKB 

4 

A.ACN:'L' 

. BLKW 

1 

A.CLI:'L' 

• BLKW 

2 


.BLKW 

2 

A.LPRV:'L' 

.BLKW 

1 

A.SID:'L' 

.BLKW 

1 

A.DDS:'L' 

.BLKB 

11. 


.BLKB 

1 

A.FPRO:'L' 

.BLKW 

1 

A.RLVL:'L' 

.BLKW 

1 

AR.LVL='B'401 



A.SALT:'L' 

.BLKW 

1 

A.ENCT:'L' 

.BLKB 

1 



.BLKB 

1 

A.HPW:'L' 

.BLKW 

4 


.IF DF 

A$$LOG 

A.TTY:'L' 

.BLKB 

5 

A.PRID:'L' 

.BLKB 

1 

A.SECD:'L' 

.BLKB 

1 

A.PRIT:'L' 

.BLKW 

1 

A. SECT:'L' 

.BLKW 

1 

A.RLEN ='B' 

• 



.ENDC 

; DF A$$LOG 

A.LEN ='B' 

/ 

128. 


r 

/ BIT DEFINITIONS ON A. 

LPRV - LOGIN 

AL.SLV='B' 

1 


AL.DDS='B' 

2 


AL.SIL='B' 

4 



.IF DF 

A$$LOG 

AL.AUT='B 1 

10 


AL.BND='B' 

20 


AL.RMT='B' 

40 


AL.NET='B' 

100 


AL.DIS='B' 

200 


AL.PRI='B' 

400 


AL.SEC='B' 

1000 



.ENDC ; DF A$$LOG 


TOTAL NUMBER OF LOGONS 
DEFAULT SYSTEM DEVICE 
ACCOUNT NUMBER (BINARY) 

RAD50 USER CLI 
UNUSED 

LOGIN PRIVILEGE WORD 
SESSION IDENTIFIER 
DEFAULT DIRECTORY STRING 
UNUSED BYTE 

DEFAULT FILE PROTECTION 
ACCOUNT RECORD REV. LEVEL 

16-BIT ENCRYPTION SALT VALUE 
ENCRYPTION TYPE 

0 = PLAIN TEXT OR ENCRYPT 
1 = PURDY-V ALGORITHM 

UNUSED 

HASHED PASSWORD 


;TERMINAL TTNNN FOR AUTO LOGIN 
;PRIMARY DAYS MASK 
;SECONDARY DAYS MASK 
;PRIMARY DAYS TIME 
/SECONDARY DAYS TIME 


/LENGTH OF CONTROL BLOCK 


PRIVILEGE BITS 

/SLAVE TERMINAL ON LOGIN 
/INDICATOR FOR PROLOGUE 2 FORMAT 
/SILENT LOGIN/LOGOUT 


/AUTO LOGIN ENABLED ('*) 

/BINDING ENABLED (’Y) 

/REMOTE DIALUP l=NO 
/NETWORK LOGIN l=NO 
/DISABLE THIS ACCOUNT FROM LOGIN 
/PRIMARY DAYS LIMIT SET 
/SECONDARY DAYS LIMIT SET 


.PSECT 
. ENDM 
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RSX-11M-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS 


CLKDF$ 


.MACRO CLKDF $,L,B 


CLOCK QUEUE CONTROL BLOCK OFFSET DEFINITIONS 
CLOCK QUEUE CONTROL BLOCK 

THERE ARE FIVE TYPES OF CLOCK QUEUE CONTROL BLOCKS. EACH CONTROL BLOCK 
HAS THE SAME FORMAT IN THE FIRST FIVE WORDS AND DIFFERS IN THE REMAINING 
THREE. THE FOLLOWING CONTROL BLOCK TYPES ARE DEFINED: 


C.MRKT='B'0 

C.SCHD='B'2 

C.SSHT=’B'4 

C.SYST='B'6 

C.SYTK='B'8. 

C.CSTP='B'10. 


MARK TIME REQUEST 

TASK REQUEST WITH PERIODIC RESCHEDULING 
SINGLE SHOT TASK REQUEST 
SINGLE SHOT INTERNAL SYSTEM SUBROUTINE 
(IDENT) 

SINGLE SHOT INTERNAL SYSTEM SUBROUTINE 
(TASK) 

CLEAR STOP BIT (CONDITIONALI ZED ON 
SHUFFLING) 


CLOCK QUEUE CONTROL BLOCK TYPE INDEPENDENT OFFSET DEFINTIONS 


.ASECT 

.=0 


C.LNK: 

1 L ' 

.BLKW 

1 

C.RQT: 

'L' 

. BLKB 

1 

C.EFN: 

1 L ' 

• BLKB 

1 

C.TCB: 

'L* 

• BLKW 

1 

C.TIM: 

1 L' 

.BLKW 

2 


;CLOCK QUEUE THREAD WORD 
;REQUEST TYPE 

;EVENT FLAG NUMBER (MARK TIME ONLY) 

;TCB ADDRESS OR SYSTEM SUBROUTINE 
; IDENTIFICATION 

;ABSOLUTE TIME WHEN REQUEST COMES DUE 


; CLOCK QUEUE CONTROL BLOCK-MARK TIME DEPENDENT OFFSET DEFINITIONS 


. =C.TIM+4 
C.AST:'L' .BLKW 1 

C.SRC:’L' .BLKW 1 
C.DST:’L' .BLKW 1 
.BLKW 1 


;START OF DEPENDENT AREA 
;AST ADDRESS 

;FLAG MASK WORD FOR 'BIS' SOURCE 
;ADDRESS OF 'BIS' DESTINATION 
;UNUSED 


• CLOCK QUEUE CONTROL BLOCK-PERIODIC RESCHEDULING DEPENDENT OFFSET DEFINITIONS 


.=C.TIM+4 
C.RSI:'L' .BLKW 2 
C.UIC:'L' .BLKW 1 
C.UAB:'L'.BLKW 1 


;START OF DEPENDENT AREA 
;RESCHEDULE INTERVAL IN CLOCK TICKS 
;SCHEDULING UIC 
;POINTER TO ASSOCIATED UAB 


; CLOCK QUEUE CONTROL BLOCK-SINGLE SHOT DEPENDENT OFFSET DEFINITIONS 


C-12 








RSX-11M-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS 


CLKDF$ (Cont.) 


.=C.TIM+4 

• BLKW 2 
.BLKW 1 
.BLKW I 


;START OF DEPENDENT AREA 
;TWO UNUSED WORDS 
;SCHEDULING UIC 
;C.UAB 


CLOCK QUEUE CONTROL BLOCK-SINGLE SHOT INTERNAL SUBROUTINE OFFSET 
DEFINITIONS 


THERE ARE TWO TYPE CODES FOR THIS TYPE OF REQUEST:'L' 

TYPE 6=SINGLE SHOT INTERNAL SUBROUTINE WITH A 16 BIT VALUE AS AN 
IDENTIFIER. 

TYPE 8=SINGLE SHOT INTERNAL SUBROUTINE WITH A TCB ADDRESS AS AN 
IDENTIFIER. 


.=C.TIM+4 
C.SUB:'L' .BLKW 1 
C.AR5:'L' .BLKW 1 
C.URM:'L'.BLKW 1 

.BLKW 1 
C.LGTH='B’. 


;START OF DEPENDENT AREA 
;SUBROUTINE ADDRESS 

;RELOCATION BASE (FOR LOADABLE DRIVERS) 
;URM TO EXECUTE ROUTINE ON 
; (MP SYSTEMS, C.SYST ONLY) 

;UNUSED 

;LENGTH OF CLOCK QUEUE CONTROL BLOCK 


NAMED DIRECTORY SUPPORT 

OFFSET C.EFN WILL BE REUSED IN SCHEDULING REQUESTS TO INDICATE IF C.UIC 
HAS A VALID UIC (C.NAM=0) OR IF C.UIC POINTS TO A CONTEXT BLOCK WITH A 
DDS. IN SCHEDULE REQUESTS, C.EFN WILL BE REFERRED TO AS C.NAM. 


C.NAM-'B’C.EFN ;FLAG WORD FOR USE WITH NAME DIRECTORIES 

; DEPENDING ON THE VALUE IN C.NAM, C.UIC WILL CONTAIN A UIC OR A POINTER 
; TO A CONTEXT BLOCK. C.UIC WILL BE REFERED TO AS C.CTX WHEN IT CONTAINS 
; A POINTER TO A CONTEXT BLOCK. 


C.CTX='B'C.UIC ,-POINTER TO CONTEXT BLOCK 

.PSECT 

.MACRO CLKDF$ X,Y 
. ENDM 
. ENDM 
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RSX-11M-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS 


CTBDFS 


.MACRO CTBDF$ 


CONTROLLER TABLE (CTB) 

THE CONTROLLER TABLE IS A CONTROL BLOCK THAT CONTAINS A 
VECTOR OF KRB ADDRESSES. THIS VECTOR MAY BE ADDRESSED 
BY THE CONTROLLER INDEX TAKEN FROM THE INTERRUPT PS BY 
$INTSV/$INTSE. 




.ASECT 




.=177756 




177756 

L.CLK: 

.BLKW 

8. 

;START OF CLOCK BLOCK (IF ANY) 

177776 

L.ICB: 

. BLKW 

1 

;ICB CHAIN FOR THIS CTB 

000000 

L.LNK: 

.BLKW 

1 

;CTB LINK WORD 

000002 

L.NAM: 

.BLKW 

1 

;GENERIC CONTROLLER NAME (ASCII) 

000004 

L.DCB: 

.BLKW 

1 

;DCB ADDRESS OF THIS DEVICE 

000006 

L.NUM: 

. BLKB 

1 

;NUMBER OF KRB ADDRESSES IN TABLE 

000007 

L.STS: 

. BLKB 

1 

;CTB STATUS BYTE 

000010 

L.KRB: 

.BLKW 

1 

;START OF KRB ADDRESSES 


NOTE: THE SYMBOL $XYCTB:: IS DEFINED FOR EACH CTB, 

WHERE THE CHARACTERS XY ARE THE SAME AS THOSE STORED IN 
L.NAM. THESYMBOL IS NOT THE START OF THE CTB, BUT THE 
START OFTHE KRB TABLE AT THE END OF THE CTB (L.KRB). 

.PSECT 


CONTROLLER TABLE STATUS BYTE BIT DEFINITIONS 


LS.CLK=1 
LS.MDC=2 
LS.CBL=4 
LS.CIN=10 
LS.NET=20 


;CLOCK BLOCK AT TOP OF CTB (1=YES) 
;MULTIDRIVER CTB (1=YES) 

;CLOCK BLK LINKED INTO CLK Q (1=YES) 
;CONT. USE COMMON INT TABLE (1=YES) 
;THIS IS DECNET DEVICE. 

;ICB'S IN K.PRM 
;(1=YES) 


COMMON INTERRUPT TABLE DISPATCH ENTRY POINTS 


Cl,CSR=-6 
CI.KRB=-4 
CI.PWF=-2 
Cl.INT=0 
Cl.DCB=2 


;CSR TEST ENTRY POINT 
;KRB STATUS CHANGE ENTRY POINT 
;POWERFAIL ENTRY POINT 
;COMMON INTERRUPT ADDRESS 
;START OF DCB TABLE (0 ENDS TABLE) 
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RSX-11M-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS 


DCBDF$ 


•MACRO DCBDF$,L,B 

+ 


DEVICE CONTROL BLOCK 

THE DEVICE CONTROL BLOCK (DCB) DEFINES GENERIC INFORMATION ABOUT A DEVICE 
TYPE AND THE LOWEST AND HIGHEST UNIT NUMBERS. THERE IS AT LEAST ONE DCB 
FOR EACH DEVICE TYPE IN A SYSTEM. FOR EXAMPLE, IF THERE ARE TELETYPES IN A 
SYSTEM, THEN THERE IS AT LEAST ONE DCB WITH THE DEVICE NAME 'TT' IF PART 
OF THE TELETYPES WERE INTERFACED VIA DLll-A'S AND THE REST VIA A DH11 THEN 
THERE WOULD BE TWO DCB'S. ONE FOR ALL DL11-A INTERFACED TELETYPES, AND ONE 
FOR ALL DH11 INTERFACED TELETYPES. 


.=0 

D.LNK:'L 
D.UCB: 'L 
D.NAM:'L 
D.UNIT: 'L 

D.UCBL:'L 
D.DSP:'L' 
D.MSK:'L' 


D.PCB:'L' 


ASECT 

.BLKW 1 
.BLKW 1 
.BLKW 1 
BLKB 1 
BLKB 1 
.BLKW 1 
BLKW 1 
BLKW 1 
BLKW 1 
BLKW 1 
BLKW 1 
BLKW 1 
BLKW 1 
BLKW 1 
BLKW 1 
BLKW 1 


•PSECT 


;LINK TO NEXT DCB 

;POINTER TO FIRST UNIT CONTROL BLOCK 
;GENERIC DEVICE NAME 

;LOWEST UNIT NUMBER COVERED BY THIS DCB 
;HIGHEST UNIT NUMBER COVERED BY THIS DCB 
;LENGTH OF EACH UNIT CONTROL BLOCK IN BYTES 
;POINTER TO DRIVER DISPATCH TABLE 
;LEGAL FUNCTION MASK CODES 0-15. 

;CONTROL FUNCTION MASK CODES 0-15. 

;NOP'ED FUNCTION MASK CODES 0-15. 

;ACP FUNCTION MASK CODES 0-15. 

;LEGAL FUNCTION MASK CODES 16.-31. 

;CONTROL FUNCTION MASK CODES 16.-31. 

;NOP'ED FUNCTION MASK CODES 16.-31. 

;ACP FUNCTION MASK CODES 16.-31. 

;LOADABLE DRIVER PCB ADDRESS 


+ 

DRIVER DISPATCH TABLE OFFSET DEFINITIONS 


D.VDEB='B'-2 

D.VCHK='B'-4 


D.VNXC='B'-4 


D.VTOU='B'-10 

D.VTIN='B'-6 


D.VINI='B'0 

D.VCAN='B'2 

D.VOUT='B'4 

D.VPWF='B'6 

D.VKRB='B'10 

D.VUCB=’B’12 


;DEALLOCATE BUFFER (S) 

;ADDRESS OF ROUTINE CALLED TO VALIDATE 
;AND CONVERT THE LBN. USED BY DRIVERS 
;THAT SUPPORT SEEK OPTIMIZATION. 

;ADDRESS OF ROUTINE IN TTDRV CALLED TO 
;HAVE IT SEND THE NEXT COMMAND IN THE 
;TYPEAHEAD BUFFER TO MCR... 

;ADDRESS OF ROUTINE IN TTDRV CALLED 
;FOR OUTPUT COMPLETION 
;ADDRESS OF ROUTINE IN TTDRV CALLED 
;FOR INPUT FROM THE CT FIRMWARE TASK 
;DEVICE INITIATOR 
;CANCEL CURRENT I/O FUNCTION 
;DEVICE TIMEOUT 
;POWERFAIL RECOVERY 
CONTROLLER STATUS CHANGE ENTRY 
;UNIT STATUS CHANGE ENTRY 
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RSX-11M-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS 


DCBDFS (Cont.) 


.IF NB SYSDEF 
D.VINT='B'14 
.ENDC 


;BEGINNING OF INTERRUPT DATA 


.MACRO DCBDF$,X,Y,Z 

. ENDM 

.ENDM 
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RSX-11M-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC 


DEFINITIONS 


EPKDF$ 


.MACRO EPKDF$, L,B 


Error Message Block Definitions 
.ASECT 

Header Subpacket 


| Subpacket Length in Bytes 


| Subpacket Flags 
+- 


| Format Identification | Operating System Code I 

+ --- - - { 

Operating System Identification i 


+ - 

| Flags 


| Entry Sequence 


| Context Code 
-+- 


| Error Sequence I 

+- - -I 

| Entry Type Subcode 
+- 

Time Stamp 


| Entry Type Code 


- - - 


| Reserved 


--- 


| Processor Type 


+ 


Processor Identification (URM) 


r 

.=0 

E$HLGH:'L' 

. BLKW 

1 

E$HSBF:'L' 

• BLKW 

1 

E$HSYS:'L' 

• BLKB 

1 

E$HIDN:'L' 

• BLKB 

1 

E$HSID:'L' 

.BLKB 

4 

E$HCTX:'L' 

.BLKB 

1 

E$HFLG:'L' 

.BLKB 

1 

E$HENS:'L' 

.BLKW 

1 

E$HERS:'L' 

.BLKW 

1 

E$HENC:'L' 

E$HTYC:'L' 

.BLKB 

1 

E$HTYS:'L' 

.BLKB 

1 

E$HTIM:'L' 

.BLKB 

6 

E$HPTY:'L' 

.BLKB 

1 


.BLKB 

1 

E$HURM:'L' 

.BLKW 

.EVEN 

1 

E$HLEN:'L' 


Subpacket length in bytes 
Subpacket Flags 
Operating System Code 
Format Identification 
Operating System Identification 
Context Code 
Flags 

Entry Sequence Number 
Error Sequence Number 
Entry Code 
Entry Type Code 
Entry Type Subcode 
Time Stamp 
Processor Type 
Reserved 

Processor Identification (URM) 


; Length 
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RSX-11M-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS 


EPKDF$ (Cont.) 


Subpacket Flags for E$HSBF 


SM.ERR ='B 1 1 

SM.HDR ='B 1 1 

SM.TSK = 1 B 1 2 

SM.DID ='B' 4 

SM.DOP ='B' 10 

SM.DAC = 1 B' 20 

SM.DAT ='B' 40 

SM.MBC = 1 B' 20000 

SM.CMD = 1 B' 40000 

SM.ZER ='B' 100000 

Codes for field E$HIDN 

EH$FOR ='B' 2 


Error Packet 
Header Subpacket 
Task Subpacket 

Device Identification Subpacket 
Device Operation Subpacket 
Device Activity Subpacket 
Data Subpacket 

22-bit massbus controller present 
Error Log Command Packet 
Zero I/O Counts 


Current packet 


format 



Flags for the error log flags byte ($ERFLA) in the Executive 


ES.INI 

= 1 B 1 

1 

; Error 

log initialized 

ES.DAT 

= * B 1 

2 

; Error 

log receiving da 

ES.LIM 

n'B' 

4 

; Error 

limiting enabled 

ES•LOG 

= ' B * 

10 

; Error 

logging enabled 


Type and Subtype Codes 


for fields E$HTYC and E$HTYS 


Symbols with names E$Cxxx are type codes for field E$HTYC, 
Symbols with names E$Sxxx are subtype codes for field E$HTYS. 


E$CCMD 

= 1 B 1 

E$SSTA 

= * B 1 

E$SSWI 

= 1 B 1 

E$SAPP 

= 'B * 

E$SBAC 

= * B 1 

E$SSHO 

= * B 1 

E$SCHL 

= 'B' 

E$CERR 

= 1 B 1 

E$SDVH 

= 1 B 1 

E$SDVS 

= 1 B 1 

E$STM0 

= 1 B 1 

E$SUNS 

= 'B' 

E$STMS 

= 1 B 1 


1 

1 

2 

3 

4 

5 

6 
2 
1 
2 

3 

4 

5 


Error Log Control 

Error Log Status Change 
Switch Logging Files 
Append File 
Declare Backup File 
Show 

Change Limits 
Device Errors 

Device Hard Error 
Device Soft Error 
Device Interrupt Timeout (HARD) 
Device Unsolicited Interrupt 
Device Interrupt Timeout (SOFT) 


E$CDVI = 1 B * 
E$SDVI = 1 B 1 


3 ; Device Information 

1 ; Device Information Message 


E$CDCI = 1 B 1 
E$SMOU = 1 B 1 
E$SDMO = 'B' 
E$SRES = 1 B 1 
E$SRCT = 'B' 


4 

1 

2 

3 

4 


Device Control Information 
Device Mount 
Device Dismount 
Device Count Reset 
Block Replacement 


E$CMEM = 1 B 1 
E$SMEM = 1 B 1 


5 ; Memory Detected Errors 

1 ; Memory Error 
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RSX-11M-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS 


EPKDF$ (Cont.) 


E$CSYS 

= 1 B ' 

6 

E$SPWR 

= * B 1 

1 

E$CCTL 

= 1 B 1 

7 

E$STIM 

= 'B ' 

1 

E$SCRS 

= ' B 1 

2 

E$SLOA 

= *B ' 

3 

E$SUNL 

= * B 1 

4 

E$SHRC 

= 'B ' 

5 

E$SMES 

= 1 B 1 

6 

E$CCPU 

= 1 B 1 

10 

E$SINT 

= ' B 1 

1 

E$SINT 

= *B * 

2 

>e code 

2 is reserved. 

E$CSDE 

= 'B' 

11 

E$SABO 

= 'B* 

1 

for Context Code entry 

EH$NOR 

= ' B 1 

1 

EH$STA 

= *B 1 

2 

EH$CRS 

= 1 B 1 

3 

for Flags entry 

e$hflg" 

EH$VIR 

= ' B * 

1 

EH$EXT 

= 1 B * 

2 

EH$COU 

= 'B' 

4 

EH$QBS 

= 1 B 1 

10 

EH$LMR 

= 1 B 1 

20 


System Control Information 
Power Recovery 

Control Information 
Time Change 
System Crash 
Device Driver Load 
Device Driver Unload 
Reconfiguration Status Change 
Message 

CPU Detected Errors 

Unexpected Interrupt 
Unexpected Interrupt 


; Software Detected Events 
; Task Abort 


; Normal Entry 
; Start Entry 
; Crash Entry 


Addresses are virtual 
Addresses are extended 
Error counts supplied 
Q-BUS CPU 
Limit reached 


Task Subpacket 

; +- - 

| Task Subpacket Length 

+ - 1 

Task Name in RAD50 I 


| Task UIC I 

+ - 

| Task TI: Device Name 


I Fla 9 s I Task TI: Unit Number I 

+ -i-1 


.=0 
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RSX-11M-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS 


EPKDF$ (Cont.) 


E$TLGH: 

'L* 

. BLKW 

1 

Task Subpacket Length 

E$TTSK: 

' L 1 

.BLKW 

2 

Task Name in RAD50 

E$TUIC: 

1 L 1 

.BLKW 

1 

Task UIC 

E$TTID: 

'L 1 

.BLKB 

2 

Task TI: Device Name 

E$TTIU: 

'L 1 

. BLKB 

1 

Task TI: Unit 

E$TFLG: 

1 L 1 

.BLKB 

1 

Flags 


.EVEN 




E$TLEN: 

'L 1 





Flags for entry E$TFLG 


ET$PRV 

ET$PRI 


'B' 

'B' 


1 ; Task is Privileged 

2 ; Terminal is Privileged 


Device Identification Subpacket 
+- 


I Device Identification Subpacket Length | 

1 - ; 

I Device Mnemonic Name I 

+ ___ +--+ 

I Controller Number I Device Unit Number 

i- -1 

| Physical Subunit # | Physical Unit # j 

I Physical Device Mnemonic (RSX-11M-PLUS only) | 

+—----! 

I Reserved | Flags 

I-!-+ 

Volume Name of Mounted Volume 


Pack Identification 


-- 


| Device Type Class 

-- 

Device Type 


- + 

-1 

I 

- + 


I/O Operation Count Longword 

_+ _ H 

I Hard Error Count I Soft Error Count 

|---H 

Blocks Transferred Count (RSX-11M-PLUS only) 


Cylinders Crossed Count (RSX-11M-PLUS only) 
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RSX-11M-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS 

EPKDF$ (Cont.) 


E$ILGH:’L' 

• BLKW 

1 

E$ILDV:'L' 

• BLKW 

1 

E$ILUN:'L' 

• BLKB 

1 

E$IPCO:'L' 

. BLKB 

1 

E$IPUN:'L' 

.BLKB 

1 

E$IPSU:'L' 

.BLKB 

1 


.IF DF 

R$$MPL 

E$IPDV:'L' 

.BLKW 

1 


.ENDC ; 

R$$MPL 

E$IFLG:'L' 

.BLKB 

1 


.BLKB 

1 

E$IVOL:'L' 

.BLKB 

12. 

E$IPAK:'L' 

E$IDEV:'L' 

.BLKB 

4 

E$IDOL:'L' 

.BLKW 

1 

E$IDTY:'L' 

.BLKW 

2 

E$IOPR:'L' 

.BLKW 

2 

E$IERS:'L' 

.BLKB 

1 

E$IERH:'L' 

.BLKB 

1 


.IF DF 

R$$MPL 

E$IBLK:'L' 

.BLKW 

2 

E$ICYL:'L' 

.BLKW 

2 


.ENDC ; 

R$$MPL 


Device Identification Subpacket Length 

Device Mnemonic Name 

Device Unit Number 

Controller Number 

Physical Unit Number 

Physical Subunit Number 


; Physical Device Mnemonic 


Flags 
Reserved 
Volume Name 
Pack Identification 
Device Type 
Device Type Class 
Device Type 
I/O Operation Count Longword 
Soft Error Count 
Hard Error Count 


Blocks transferred count 
Cylinders crossed count 


; Subpacket Length 


.EVEN 

E$ILEN:'L' 

Flags for field E$IFLG 

El$SUB =*3* 1 ; Subcontroller device 

.IF DF R$$MPL 

El$NUX =1 B' 2 ; No UCB extension, data invalid 

•ENDC ; R$$MPL 

Device Operation Subpacket 

+- 

l 

+ 


Device Operation Subpacket Length 
Task Name in RAD50 


| Task UIC 


| Task TIs Logical Device Mnemonic 

+--- 
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EPKDF$ (Cont.) 


-- + 

| Task TIs Device Unit | 
_+ 


I Reserved 

--+- 

I I/O Function Code 

--+-7- 

I Reserved | Operation Flags 

+- : --- 

I Transfer Operation Address 


Transfer Operation Byte Count 

I Retries Left 


• + — — — — — — — — — — — — — — — — 

; | Maximum Retri< 

. +- 



1=0 

E$OLGN:'L' 

• BLKW 

1 

E$OTSK:'L' 

• BLKW 

2 

E$OUIC:'L' 

• BLKW 

1 

E$OTID:'L' 

• BLKB 

2 

E$OTIU:'L' 

• BLKB 

1 


• BLKB 

1 

E$OFNC:'L' 

• BLKW 

1 

E$OFLG:'L' 

• BLKB 

1 


• BLKB 

1 

E$OADD:'L' 

• BLKW 

2 

E$OSIZ: 'L' 

• BLKW 

1 

E$ORTY:'L' 

• BLKB 

1 

.EVEN 

• BLKB 

1 

E$OLEN:'L' 

; Flags for field E$OFLG 

EO$TRA 

= 1 B 1 


EO$DMA 

= , B* 


EO$EXT 

= 1 B 1 


EO$PIP 

= «B f 


EO$IIO 

= 'B' 



-+ 

l 

-+ 

-+ 

I 

-+ 

i 

-+ 


1 

2 

4 

10 

20 


Subpacket Length 
Task Name in RAD50 
Task UIC 

Task TIs Logical Device Mnemonic 
Task TIs Logical Device Unit 
Reserved 

I/O Function Code 
Operation Flags 
Reserved 

Transfer Operation Address 
Transfer Operation Byte Count 
Retries Left 
Maximum Retries 


Device Operation Subpacket Length 


Transfer Operation 
DMA Device 

Extended Addressing Device 
Device is positioning 
Internal I/O operation 


I/O Activity Subpacket 
+- 


I/O Activity Subpacket Length 


.=0 

E$ALGH s 1 L 1 .BLKW 1 ; Subpacket Length 
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EPKDF$ (Cont.) 


I/O 


Activity Subpacket Entry 
+- 


Logical Device Name Mnemonic 


| Controller Number | Logical Device Unit 

+ + -- 

Physical Subunit # | Physical Unit Number I 

+ -7---{ 

Physical Device Mnemonic (RSX-11M-PLUS only) I 

+ --- • 

| Task TI: logical unit | Device flags 

| Requesting Task Name in RAD50 


| Requesting Task UIC 


| Task TI: Logical Device Name 


-+ 

I 

- + 


| I/O Function Code 


| Reserved I Flags 

+- 1 - 

| Transfer Operation Address 


Transfer Operation Byte Count 


• 

II 

o 



E$ALDV:'L' 

• BLKW 

1 

E$ALUN:'L' 

• BLKB 

1 

E$APCO:'L' 

• BLKB 

1 

E$APUN:'L' 

.BLKB 

1 

E$APSU:'L' 

.BLKB 

1 


.IF DF 

R$$MPL 

E$APDV:'L' 

.BLKW 

1 


• ENDC 


E$ADFG:'L' 

.BLKB 

1 

E$ATIU:'L' 

.BLKB 

1 

E$ATSK:'L' 

.BLKW 

2 

E$AUIC:'L' 

.BLKW 

1 

E$ATID:'L' 

.BLKW 

1 

E$AFNC:'L' 

.BLKW 

1 

E$AFLG:'L' 

.BLKB 

1 


.BLKB 

1 

E$AADD:'L' 

.BLKW 

2 

E$ASIZ:'L' 

.BLKW 

1 

.EVEN 




Logical Device Name Mnemonic 
Logical Device Unit 
Controller Number 
Physical Unit Number 
Physical Subunit Number 


; Physical Device Mnemonic 


Device flags 

Task TI: Logical Unit 

Requesting Task Name in RAD50 

Requesting Task UIC 

Task TI: Logical Device Name 

I/O Function Code 

Flags 

Reserved 

Transfer Operation Address 
Transfer Operation Byte Count 
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EPKDF$ (Cont.) 


E$ALEN:'L' 

; Flags for field E$ADFG 

EA$SUB ='B 1 1 

.IF DF R$$MPL 
EA$NUX ='B' 2 

.ENDC ; R$$MPL 
; Flags for field E$AFLG 


EA$TRA ='B' 1 

EA$DMA ='B' 2 

EA$EXT ='B' 4 

EA$PIP = 1 B 1 10 

EA$I10 ='B' 20 

.PSECT 


; Subpacket Entry Length 


; Subcontroller device 


; No UCB extension, data invalid 


Transfer Operation 
DMA Device 

Device has Extended Addressing 
Device is positioning 
Internal I/O operation 


FLAG DEFINITIONS FOR ERROR LOG FEATURE MASK 


EL.ICM ='B ' 1 

EL.SEF =' B ' 2 

EL.MOU ='B ' 4 


;SET - Inhibit Operator Console Messages 
;SET - Special File Formats Enabled 
;SET - Process MOU/DMO In Special Files 


• MACRO EPKDF $ X,Y 
.ENDM 


. ENDM 
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RSX-11M-PLUS SYSTEM DATA STRUCTURES AND 


SYMBOLIC DEFINITIONS 


EVNDF$ 


.MACRO EVNDF$ L,B,LST 


EVNDF$ — Event Packet Definiti 


ons 


This module contains a macro which defines the offsets and fi«id 
values for TSA Event Pankpf-Q /mpni sno field 


Explicit Inputs: 


L 

B 

LST 


for global offset definitions 

bit/value definitions 
LIST for macro expansion listing 


Implicit Inputs: 


NONE 
Outputs: 

Symbols defined as described above. 
Listing as described above. 


General packet header format 


.ASECT 



.=0 



E.VLNK: 1 L 1 

• BLKW 

1 

E.VSIZ:'L* 

. BLKB 

1 

E.VTYP:'L ' 

.BLKB 

1 

E.VUCB: ' L ' 

.BLKW 

1 


; Define offsets absolutely 

; Link word 
; Packet size 
; Packet type 
; Terminal UCB address 


E.VTYP Values 


ET.LOW='B 

'0 

ET.QIO='B 

'0 

ET.BND='B 

•2 

ET.UNB='B 

'4 

ET.BCP='B 

'6 

ET.REJ='B 

'10 

ET.DIS='B 

'12 

ET.DCP= 'B 1 

'14 

ET.ICS='B' 

'16 

ET.OOB='B 1 

'20 

ET.ONO='B' 

'22 

ET.PHO='B 1 

'24 

ET.HI='B 1 24 


; Lowest valid type code 

, QIO (distinguishes QIO packet from TEP) 
; Bind Request 
; Unbind Request 
; Bind Complete 
; Bind Reject 
; Disconnect Notification 
; Disconnect Complete 
; Input Count State Change 
; Out-of-Band (00B) 

; Abnormal Termination Request 
; Physical Terminal Disconnected 

; Highest valid type code 
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RSX-11M-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS 

EVNDF$ (Cont.) 


The following definitions are for packet types that require 
passing additional information in the packets. All othe 
packet types use the general packet format described above. 


Bind Request packet (Terminal Management Mode —> Network) 
.=E.VUCB+2 


.VBCT:'L' 
,VBND: 1 L 1 
. VBLN:'L' 


.BLKW 
. BLKB 


1 

6 


Count of nodes (One for now) 
Node name 

Length of bind request 


input Count State Change, Out-Of-Band packets (TTDRV —> Network) 
And Modem Hang-up packets (TSA... —> Network) 


,=E.VUCB+2 


E.VAPR: 1 L 1 
E.VADR: , L' 
E.VFLG:'L* 


.BLKW 

.BLKW 

.BLKW 


1 

1 

1 


Doubleword address of packet, 
...queueing routine 
Flag 


Input Count State Change 
.=E.VFLG+2 
E.VSLN: 1 L * 


Length of Input state message 


00B 

. =E 

.VFLG+2 


E.VOBM:'L' 

.BLKW 

6 

E.VHDR:'L' 

.BLKW 

2 

E.VTAB:'L' 

.BLKB 

10. 

E.VOLN:'L' 

t 

; Terminal 

Management 

Switch 

r 

. =E 

i. VFLG + 2 


E.VSWC:'L' 

.BLKW 

1 

E.VTLN:'L' 


; Out-of-Band bitmasks 
; Type-ahead buffer header 
; Type-ahead buffer 
; Length of 00B packet 


Terminal management switch characters 
Length of Switch Character packet 


Bit values in flag word (E.VFLG). For convenience some:bitshave 
corresponding bits in the AST Control Block flag word (A.PRM+5). 
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EVNDF$ (Cont.) 


EF.NCO='B'l 
EF.NOI= 1 B'2 
EF.AST='B'10 
EF.LCK='B'40 
EF.QUE='B'100 
EF.MDE='B'200 


All non-control characters are out-of band 


All non-control OOB are 
Reserved bit synonymous 
Reserved bit synonymous 
TEP is queued 
TEP is marked for delete 


include-OOB 
with TF.AST 
with AF.LCK 


Unbind Request packet (TMM —> Network) 
.=E.VUCB+2 


E.VULN:'L' 


Length of Unbind message 


Connect Reject notification packet (Network —> TMM) 
.=E.VUCB+2 


E.VRR:'L' .BLEW 1 

E.VRLN:'L' 


; Reason for Rejection 
; Length of Reject message 


Disconnect Notification packet (Network —> TMM) 
.=E.VUCB+2 


E.VRD: 1 L * .BLKW 1 

E.VDLN:'L' 


Reason for Disconnect 
Length of Disconnect message 


Disconnect Complete packet (TMM —> Network) 
.=E.VUCB+2 


E.VDCL:'L 1 


Length of Disconnect Complete 


message 


.PSECT 


IF NB 

LST 

.NLIST 


IFF 


.MACRO 
• ENDM 

EVNDF$ 

ENDC 


.ENDM 

EVNDF$ 


; Turn listing back off 

} If not listing , redefine 
; macro to nothing 
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RSX-11M-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS 


F11DF$ 


.MACRO F11DF$,L,B 


VOLUME CONTROL BLOCK 


.=0 


•ASECT 


V.TRCT:'L'.BLKW 1 
V.TYPE:'L'.BLKB 1 

VT .FOR='B 1 0 
VT.SL1='B' 1 

VT ,SL2='B' 2 
VT .ANS='B' 10 
VT .UNL='B ' 11 
V.VCHA:'L'.BLKB 1 

VC.SLK='B' 1 

VC.HLK='B' 2 
VC.DEA= 1 B' 4 
VC.PUB= 1 B' 10 
VC .DUP='B' 20 
VC.SIL ='B 1 40 
V.LABL:'L'.BLKB 14 
V.PKSR:'L'.BLKW 2 
V.SLEN:'L' 

V.IFWI:'L'.BLKW 1 
V.FCB:'L'.BLKW 2 
V.IBLB:'L'.BLKB 1 
V.IBSZ:'L'.BLKB 1 
•BLKW 1 
V.FMAX:'L'.BLKW 1 
V.WISZ:'L'.BLKB 1 

V.SBCL:'L'.BLKB 1 
V.SBSZ:'L'.BLKW 1 
V.SBLB:'L'.BLKB 1 
V.FIEX:'L'.BLKB 1 
.BLKW 1 


TRANSACTION COUNT 

VOLUME TYPE DESCRIPTOR 

FOREIGN VOLUME STRUCTURE 

FILES-11 STRUCTURE LEVEL 1 

FILES-11 STRUCTURE LEVEL 2 

ANSI LABELED TAPE 

UNLABELED TAPE 

VOLUME CHARACTERISTICS 

CLEAR VOLUME VALID ON DISMOUNT 

UNLOAD THE VOLUME ON DISMOUNT 

DEALLOCATE THE VOLUME ON DISMOUNT 

SET (CLEAR) US.PUB ON DISMOUNT 

DUPLICATE VOLUME NAME; DON'T DELETE LOGICALS 

SILENT MODE; SUPPRESS DISMOUNT COMPLETE MESSAGE 

VOLUME LABEL (ASCII) 

PACK SERIAL NUMBER FOR ERROR LOGGING 

LENGTH OF SHORT VCB 

INDEX FILE WINDOW 

FILE CONTROL BLOCK LIST HEAD 

INDEX BIT MAP 1ST LBN HIGH BYTE 

INDEX BIT MAP SIZE IN BLOCKS 

INDEX BITMAP 1ST LBN LOW BITS 

MAX NO. OF FILES ON VOLUME 

DEFAULT SIZE OF WINDOW IN RTRV PTRS 

VALUE IS < 128. 

STORAGE BIT MAP CLUSTER FACTOR 
STORAGE BIT MAP SIZE IN BLOCKS 
STORAGE BIT MAP 1ST LBN HIGH BYTE 
DEFAULT FILE EXTEND SIZE 
STORAGE BIT MAP 1ST LBN LOW BITS 


; WARNING 

the FOLLOWING CELLS OF THE VCB ARE ORDER DEPENDENT. 
• THEY ARE RETURNED BY A READ ATTRIBUTES FUNCTION AND 
; MUST BE KEPT CONTIGUOUS. IF THE ORDER OF THE CELLS 
; IS BROKEN, THE CODE MAY BREAK AS WELL. 


V.VOWN:'L'.BLKW 1 
V.VPRO:'L'.BLKW 1 
V.FPRO:'L'.BLKW 1 
V.FRBK:’L'.BLKB 1 
V.LRUC:'L'.BLKB 1 
.BLKW 1 


VOLUME OWNER'S UIC 

VOLUME PROTECTION 

VOLUME DEFAULT FILE PROTECTION 

NUMBER OF FREE BLOCKS ON VOLUME HIGH BYTE 

COUNT OF AVAILABLE LRU SLOTS IN FCB LIST 

NUMBER OF FREE BLOCKS ON VOLUME LOW BITS 
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F11DF$ (Cont.) 


WARNING 


THE ABOVE CELLS OF THE VCB ARE ORDER DEPENDENT 

d \ RE RETURNED by a READ ATTRIBUTES FUNCTION AND 
MUST BE KEPT CONTIGUOUS. IF THE ORDER OF THE CELLS 
IS BROKEN, THE CODE MAY BREAK AS WELL. 


V.STS:'L'.BLKB 1 
VS . IFW = ' B ' 
VS.BMW='B' 
V.FFNU:'L'.BLKB 
V.EXT:'L'.BLKW 
V.HBLB:'L'.BLKW 
V.HBCS:'L'.BLKW 
V.LGTH:'L' 


1 

1 

2 

2 


VOLUME STATUS BYTE, CONTAINING THE FOLLOWING 

INDEX FILE IS WRITE ACCESSED 

STORAGE BITMAP FILE IS WRITE ACCESSED 

FIRST FREE INDEX FILE BITMAP BLOCK 

POINTER TO VCB EXTENSION 

LBN OF HOME BLOCK 

HOME BLOCK CHECKSUMS 

SIZE IN BYTES OF VCB 


MOUNT LIST ENTRY 

EACH ENTRY ALLOWS ACCESS TO A SPECIFIED USER FOR A NON-PUBLIC DEVICE 

dev?ce°access N ^o?ks°" LI ™ E mLY TIPE C0DE DBFImD IS " 1 " F0B 


.ASECT 


.=0 


M.LNK:'L'.BLKW 1 
M.TYPE:'L'.BLKB 1 
MT.MLS='B’ 
M.ACC:'L'.BLKB 1 
M.DEV:'L'.BLKW 1 
M.TI:'L'.BLKW 1 
M.LEN:'L' 


FILE CONTROL BLOCK 


LINK WORD 
TYPE OF ENTRY 

MOUNTED VOLUME USER ACCESS LIST 

NUMBER OF ACCESSES 

DEVICE UCB 

ACCESSOR TI: UCB 

LENGTH OF ENTRY 


.=0 


.ASECT 


F.LINK:'L'.BLKW 1 
F.FNUM:'L'.BLKW 1 
F.FSEQ:'L'.BLKW 1 
.BLKB 1 
F.FSQN:'L'.BLKB 1 
F.FOWN:'L'.BLKW 1 
F.FPRO:'L'.BLKW 1 
F.UCHA:'L'.BLKB 1 
F.SCHA: 'L' .BLKB 1 
F.HDLB:'L'.BLKW 2 


FCB CHAIN POINTER 
FILE NUMBER 
FILE SEQUENCE NUMBER 
NOT USED 

FILE SEGMENT NUMBER 

FILE OWNER'S UIC 

FILE PROTECTION CODE 

USER CONTROLLED CHARACTERISTICS 

SYSTEM CONTROLLED CHARACTERISTICS 

FILE HEADER LOGICAL BLOCK NUMBER 
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F11DF$ (Cont.) 


F.LBN:'L'.BLKW 2 

F.SIZE:'L'.BLKW 2 
F.NACS:'L'.BLKB 1 
F.NLCK:'L'.BLKB 1 
S.STBK='B'.-F.LBN 


BEGINNING OF STATISTICS BLOCK 

LBN OF VIRTUAL BLOCK 1 IF CONTIGUOUS 

0 IF NON CONTIGUOUS 

SIZE OF FILE IN BLOCKS 

NO. OF ACCESSES 

NO. OF LOCKS 

SIZE OF STATISTICS BLOCK 


F.STAT:'L' } 

F.NWAC: 'L'.BLKB 1 

.BLKB 1 ; 

. FC.WAC='B 1 100000 
FC.DIR= 1 B' 40000 
FC.CEF= 1 B' 20000 
FC.FCO='B' 10000 
F.DREF: 'L' .BLKW 1 

F.DRNM:'L'.BLKW 1 ; 

F.FEXT:'L'.BLKW 1 } 

F.FVBN:'L'.BLKW 2 ; 

F.LKL:'L'.BLKW 1 } 

F.WIN:'L'.BLKW 1 i 

F.LGTH:'L' J 


FCB STATUS WORD 

NUMBER OF WRITE ACCESSORS 

STATUS BITS FOR FCB CONSISTING OF 

; SET IF FILE ACCESSED FOR WRITE 

; SET IF FCB IS IN DIRECTORY LRU 

; SET IF DIRECTORY EOF NEEDS UPDATING 

; SET IF TRYING TO FORCE DIRECTORY CONTIG 

DIRECTORY EOF BLOCK NUMBER 

1ST WORD OF DIRECTORY NAME 

POINTER TO EXTENSION FCB 

STARTING VBN OF THIS FILE SEGMENT 

POINTER TO LOCKED BLOCK LIST FOR FILE 

WINDOW BLOCK LIST FOR THIS FILE 

SIZE IN BYTES OF FCB 


; WINDOW 


.=0 


.ASECT 


W.ACT:'L' ; 

} 

W.BLKS:'L' ; 

t 

W.CTL:'L'.BLKW 1 ; 

1 

WI.RDV='B' 400 
WI.WRV='B' 1000 
WI.EXT='B' 2000 
WI.LCK= 'B' 4000 
WI.DLK='B' 10000 
WI.PND='B 1 20000 
WI.EXL= 1 B' 40000 
WI.WCK='B' 100000 
W.IOC:'L'.BLKB 1 ; 

.BLKB 1 ; 

W.FCB:'L'.BLKW 1 } 

W.TCB:'L'.BLKW 1 ; 

W.UCB:'L'.BLKW 1 ; 

W.LKL:'L'.BLKW 1 } 

W.WIN:'L'.BLKW 1 J 


NUMBER OF ACTIVE MAPPING POINTERS 
WHEN NO SECONDARY POOL 
BLOCK SIZE OF SECONDARY POOL SEGMENT 
WHEN SECONDARY POOL 
LOW BYTE = # OF MAP ENTRIES ACTIVE 
HIGH BYTE CONSISTS OF CONTROL BITS 
; READ VIRTUAL BLOCK ALLOWED IF SET 
; WRITE VIRTUAL BLOCK ALLOWED IF SET 
; EXTEND ALLOWED IF SET 
; SET IF LOCKED AGAINST SHARED ACCESS 
; SET IF DEACCESS LOCK ENABLED 
; WINDOW TURN PENDING BIT 
; SET IF MANUAL UNLOCK DESIRED 
; DATA CHECK ALL WRITES TO FILE 
COUNT OF I/O THROUGH THIS WINDOW 
RESERVED 

FILE CONTROL BLOCK ADDRESS 
TCB ADDRESS OF ACCESSOR 
ORIGINAL UCB ADDRESS OF DEVICE 
POINTER TO LIST OF USERS LOCKED BLOCKS 
WINDOW BLOCK LIST LINK WORD 


.IF NB,SYSDEF ; IF SYSDEF SPECIFIED IN CALL 


.IF NDF,P$$WND ; IF SECONDARY POOL WINDOWS NOT ALLOWED 


O 
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F11DF$ (Cont.) 


NON-SECONDARY POOL WINDOW BLOCK 

IF SECONDARY POOL WINDOWS ARE NOT ENABLED, THE WINDOW BLOCK 
CONTAINS THE CONTROL INFORMATION AND RETRIEVAL POINTERS. 


W.VBN:'L'.BLKB 1 
W.MAP:'L' 

W.WISZ:'L'.BLKB 1 
.BLKW 1 
W.RTRV:'L' 


W.SLEN='B'-4 


.IFF 


HIGH BYTE OF 1ST VBN MAPPED BY WINDOW 

DEFINE LABEL WITH ODD ADDRESS TO CATCH BAD REFS 

SIZE IN RTRV PTRS OF WINDOW (7 BITS) 

LOW ORDER WORD OF 1ST VBN MAPPED 

OFFSET TO 1ST RETRIEVAL POINTER IN WINDOW 

DUMMY DEFINITION TO PREVENT INCORRECT REFERENCE 
(-4 WHEN ROUNDED "UP" IS A VERY LARGE BLOCK) 

IF WINDOWS IN SECONDARY POOL 


SECONDARY POOL WINDOW CONTROL AND MAPPING BLOCK 


IF SECONDARY POOL WINDOW BLOCKS ARE ENABLED, LUTN2 POINTS 
TO A CONTROL BLOCK IN SYSTEM POOL WHICH CONTAINS THE 
FOLLOWING CONTROL FIELDS AND THE MAPPING INFORMATION 
FOR THE SECONDARY POOL WINDOW. 


W.MAP:'L'.BLKW 1 ; ADDR TO THE MAPPING PTRS IN SECONDARY POOL 

W.SLEN:'L' ; LENGTH OF PRIMARY POOL STUB 


SECONDARY POOL WINDOW 

IF SECONDARY POOL WINDOW BLOCKS ARE ENABLED, THE RETRIEVAL 
POINTERS ARE MAINTAINED IN SECONDARY POOL IN THE FOLLOWING 
FORMAT. 


.=0 


ASSUME W.CTL,0 


.BLKB 1 
W.USE:'L'.BLKB 1 
W.VBN:'L'.BLKB 1 
W.WISZ:'L'.BLKB 1 
•BLKW 1 
W.RTRV:'L' 


NUMBER OF ACTIVE MAPPING POINTERS 
STATUS OF BLOCK 

HIGH BYTE OF 1ST VBN MAPPED BY WINDOW 
SIZE IN RTRV PTRS OF WINDOW (7 BITS) 

LOW ORDER WORD OF 1ST VBN MAPPED 

OFFSET TO 1ST RETRIEVAL POINTER IN WINDOW 


. ENDC 


END SECONDARY POOL WINDOW CONDITIONAL 


.ENDC 


END SYSDEF CONDITIONAL 


LOCKED BLOCK LIST NODE 


.=0 


.ASECT 
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F11DF$ (Cont.) 


L.LNK: 

'L'.BLKW 

1 

LINK TO NEXT NODE 

IN LIST 

L.WI1: 

'L'.BLKW 

1 

POINTER TO WINDOW 

FOR FIRST 

L.VB1: 

'L'.BLKB 

1 

HIGH ORDER VBN BYTE 

L.CNT: 

'L'.BLKB 

1 

COUNT FOR ENTRY 



.BLKW 

1 

LOW ORDER VBN 


L.LKSZ 

: 'L* 




; END 

OF DEFINITIONS 




.PSECT 

.MACRO 

F11DF$ : 

<,Y,Z 



. ENDM 

F11DF$ 




. ENDM 

F11DF$ 
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HDRDF$ 


•MACRO HDRDF$,L,B 


/ + 

; TASK HEADER OFFSET DEFINITIONS 


•ASECT 

. =0 

H.CSP:'L'.BLKW 1 
H.HDLN:'L'.BLKW 1 
H.SMAP:'L'.BLKB 1 
H.DMAP:'L'.BLKB 1 
H.FMAP:'L'.BLKW 1 
H.CUIC:'L'.BLKW 1 
H.DUIC:'L'.BLKW 1 
H.IPS:'L'.BLKW 1 
H.IPC:'L'.BLKW 1 
H.ISP:'L'.BLKW 1 
H.ODVA:'L'.BLKW 1 
H.ODVL:'L'.BLKW 1 
H.TKVA:'L'.BLKW 1 
H.TKVL:'L'.BLKW 1 
H.PFVA:'L'.BLKW 1 
H.FPVA:'L'.BLKW 1 
H.RCVA:'L'.BLKW 1 
H.EFSV:'L'.BLKW 1 
H.FPSA:'L'.BLKW 1 
H.WND:'L'.BLKW 1 
H.DSW:'L'.BLKW 1 
H.FCS:'L'.BLKW 1 
H.FORT:'L'.BLKW 1 
H.OVLY:'L'.BLKW 1 
H.VEXT:'L'.BLKW 1 
H.SPRI:'L'.BLKB 1 
H.NML:'L'.BLKB 1 
H.RRVA:'L'.BLKW 1 

H.X25:'L'.BLKB 1 
•BLKB 1 
.BLKW 2 
H.GARD:'L'.BLKW 1 
H.NLUN:'L'.BLKW 1 
H.LUN:*L’.BLKW 2 


;CURRENT STACK POINTER 
;HEADER LENGTH IN BYTES 
SUPERVISOR D SPACE OVERMAP MASK 
;USER D SPACE OVERMAP MASK 
;POINTER TO FAST MAP SECTION OF HDR 
;CURRENT TASK UIC 
;DEFAULT TASK UIC 

;INITIAL PROCESSOR STATUS WORD (PS) 

;INITIAL PROGRAM COUNTER (PC) 

;INITIAL STACK POINTER (SP) 

;ODT SST VECTOR ADDRESS 

;ODT SST VECTOR LENGTH 

;TASK SST VECTOR ADDRESS 

;TASK SST VECTOR LENGTH 

;POWER FAIL AST CONTROL BLOCK ADDRESS 

;FLOATING POINT AST CONTROL BLOCK ADDRESS 

;RECIEVE AST CONTROL BLOCK ADDRESS 

;EVENT FLAG ADDRESS SAVE ADDRESS 

;POINTER TO FLOATING POINT/EAE SAVE AREA 

;POINTER TO NUMBER OF WINDOW BLOCKS 

;TASK DIRECTIVE STATUS WORD 

;FCS IMPURE POINTER 

;FORTRAN IMPURE POINTER 

;OVERLAY IMPURE POINTER 

;WORK AREA EXTENSION VECTOR POINTER 

;PRIORITY DIFFERENCE FOR SWAPPING 

;NETWORK MAILBOX LUN 

;RECEIVE BY REFERENCE AST CONTROL BLOCK 
; ADDRESS 

;FOR USE BY X25 SOFTWARE 
;5 RESERVED BYTES 
} 

;POINTER TO HEADER GUARD WORD 
;NUMBER OF LUN’S 
;START OF LOGICAL UNIT TABLE 


LENGTH OF FLOATING POINT SAVE 


H.FPSL='B'25.*2 

; + 

; WINDOW BLOCK OFFSETS 


.=0 

W.BPCB:'L'.BLKW 1 
W.BLVR:'L'.BLKW 1 
W.BHVR:'L'.BLKW 1 
W.BATT:'L'.BLKW 1 
W.BSIZ:'L'.BLKW 1 


AREA 


;PARTITION CONTROL BLOCK ADDRESS 
;LOW VIRTUAL ADDRESS LIMIT 
;HIGH VIRTUAL ADDRESS LIMIT 
;ADDRESS OF ATTACHMENT DESCRIPTOR 
;SIZE OF WINDOW IN 32W BLOCKS 


C-33 












RSX-11M-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS 


HDRDF$ (Cont.) 


W.BOFF:'L'.BLKW 1 
W.BFPD:'L'.BLKB 1 
W.BNPD:'L'.BLKB 1 
W.BLPD:'L'.BLKW 1 
W.BLGH:'L' 


;PHYSICAL MEMORY OFFSET IN 32W BLOCKS 
;FIRST PDR ADDRESS 
;NUMBER OF PDR'S TO MAP 
;CONTENTS OF LAST PDR 
;LENGTH OF WINDOW DESCRIPTOR 


BIT DEFINITION FOR W.BLPD 


WB.NBP='B'20 

WB.BPS='B'40 


;CACHE BYPASS NOT DESIRED FOR THIS WINDOW 
;ALWAYS BYPASS THE CACHE FOR THIS WINDOW 


.PSECT 

.MACRO HDRDF$ X,Y 
. ENDM 
. ENDM 
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HWDDF$ 



.MACRO HWDDF$,L,B 

MACROS FOR DEFINING MAPPING REGISTER DEFINITIONS 


.MACRO CRESET NAM.ADDR 

$$$ = 0 

.REPT 8. 

CRENAM NAM,ADDR+<$$$2>,$$$ 

$$$=$$$+1 

.ENDR 
. ENDM 


.MACRO CRENAM NAM,ADDR,N 
1 NAM 1 'N'==ADDR 
.ENDM 


HARDWARE REGISTER ADDRESSES AND STATUS CODES 


MPCSR= 1 B ' 177746 


MPAR 
PIRQ= ' 
PR0= * B 
PR1='B 
PR4= 1 B 
PR5= 'B 
PR6= 1 B 
PR7= 'B 
PS='B 1 
SWR='B 
TPS= 1 B 


B 1 172100 
B ' 177772 
0 

40 

200 

240 

300 

340 

177776 

'177570 

'177564 


;ADDRESS OF PDP-11/70 MEMORY PARITY 
; REGISTER 

;ADDRESS OF FIRST MEMORY PARITY REGISTER 
;PROGRAMMED INTERRUPT REQUEST REGISTER 
;PROCESSOR PRIORITY 0 
;PROCESSOR PRIORITY 1 
;PROCESSOR PRIORITY 4 
;PROCESSOR PRIORITY 5 
;PROCESSOR PRIORITY 6 
;PROCESSOR PRIORITY 7 
;PROCESSOR STATUS WORD 
;CONSOLE SWITCH AND DISPLAY REGISTER 
;CONSOLE TERMINAL PRINTER STATUS REGISTER 


EXTENDED ARITHMETIC ELEMENT REGISTERS 


.IF DF E$$EAE 


AC= *B'177302 
MQ= 'B ' 177304 
SC= , B*177310 

. ENDC 


;ACCUMULATOR 
;MULTIPLIER-QUOTIENT 
;SHIFT COUNT 


+ 

MEMORY MANAGEMENT HARDWARE REGISTERS AND STATUS CODES 


. IF NB 

B 





CRESET 

KINAR,172340 

;KERNEL 

I 

PAR 

'S 

CRESET 

KINDR,172300 

;KERNEL 

I 

PDR 1 

'S 

CRESET 

KDSAR,172360 

;KERNEL 

D 

PAR' 

'S 

CRESET 

KDSDR,172320 

;KERNEL 

D 

PDR 1 

'S 
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HWDDF$ (Cont.) 


UBMPR= 1 
CMODE= 1 
PMODE=' 
CSMODE= 
PSMODE= 
SR0= 1 B 1 
SR3= 1 B' 
CPUERR= 
MEMERR= 
MEMCTL= 


CRESET 

SISAR,172240 

;SUPERVISOR I PAR’ 

■s 

CRESET 

SISDR,172200 

SUPERVISOR I PDR' 

'S 

CRESET 

SDSAR,172260 

SUPERVISOR D PAR 

'S 

CRESET 

SDSDR,172220 

SUPERVISOR D PDR 

'S 

CRESET 

UINAR,177640 

;USER I PAR'S 


CRESET 

UINDR,177600 

;USER I PDR'S 


CRESET 

UDSAR,177660 

;USER D PAR’S 


CRESET 

UDSDR,177620 

;USER D PDR'S 


. ENDC 




.IF NB 

SYSDEF 



• IF DF 

K$$DAS 



CRESET 

KISAR,172360 

;KERNEL D PAR'S 


CRESET 

KISDR,172320 

;KERNEL D PDR'S 


.IFF 




CRESET 

KISAR,172340 

;KERNEL I PAR'S 


CRESET 

KISDR,172300 

;KERNEL I PDR'S 


.ENDC 




.IF DF 

U$$DAS 



CRESET 

UISAR,177660 

;USER D PAR'S 


CRESET 

UISDR,177620 

;USER D PDR'S 


.IFF 

; DF U$$DAS 



CRESET 

UISAR,177640 

;USER I PAR’S 


CRESET 

UISDR,177600 

;USER I PDR'S 


.ENDC 

; DF U$$DAS 



.ENDC 




B ' 170200 


;UNIBUS MAPPING REC 


B ' 140000 
B 1 30000 
' B'4 0000 
1 B'10000 
177572 
172516 
: 'B 1 177766 
; 'B 1 177744 
: 'B'177746 


;CURRENT MODE FIELD OF PS WORD 
;PREVIOUS MODE FIELD OF PS WORD 
;CURRENT MODE = SUPERVISOR PS WORD BITS 
;PREVIOUS MODE = SUPERVISOR PS WORD BITS 
;SEGMENT STATUS REGISTER 0 
;SEGMENT STATUS REGISTER 3 
;CPU ERROR REGISTER 
;MEMORY SYSTEM ERROR REGISTER 
;MEMORY CONTROL REGISTER 


DEFINE THE LOCATIONS USED IN THE NON-VOLATILE RAM (NVR) 
FOR XT SYSTEMS 


N . KEY= 'B 1 17 30 54 
N•UPT='B 1 173064 
N.DZA= 1 B' 173074 
N.DWA =, B' 173104 
N.DAY='B 1 173114 
N•MON= 1 B 1 17 3116 
N.YEA='B' 173120 


NUMBER OF KEYS PRESSED 

UPTIME IN MINUTES 

NUMBER OF I/OS DONE ON THE DZ 

NUMBER OF I/OS DONE ON THE DW 

DATE THAT THE NVR WAS LAST INITIALIZED 
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HWDDF$ (Cont.) 


+ 

FEATURE SYMBOL DEFINITIONS 


FE. EXT = 
FE.MUP= 
FE.EXV= 
FE.DRV= 
FE.PLA= 
FE.CAL= 
FE.PKT= 
FE.EXP= 
FE.LSI= 
FE.OFF= 
FE.FDT= 
FE.X25= 
FE.DYM= 
FE.CEX= 
FE.MXT= 
FE.NLG= 


: 'B ' 1 
: 'B ' 2 
•' B ' 4 
; 'B'10 
•B'20 
'B'40 
'B '100 
: 'B'200 
'B 1 400 
'B'1000 
'B'2000 
'B'4000 
'B ' 10000 
'B'20000 
'B ' 40000 
'B ' 100000 


;22-BIT EXTENDED MEMORY SUPPORT 
;MULTI-USER PROTECTION SUPPORT 
EXECUTIVE IS SUPPORTED TO 20K 
;LOADABLE DRIVER SUPPORT 
;PLAS SUPPORT 

;DYNAMIC CHECKPOINT SPACE ALLOCATION 
;PREALLOCATION OF I/O PACKETS 
;EXTEND TASK DIRECTIVE SUPPORTED 
;PROCESSOR IS AN LSI-11 
;PARENT/OFFSPRING TASKING SUPPORTED 
;FULL DUPLEX TERMINAL DRIVER SUPPORTED 
;X.25 CEX IS LOADED 

;DYNAMIC MEMORY ALLOCATION SUPPORTED 
;COM EXEC IS LOADED 
;MCR EXIT AFTER EACH COMMAND MODE 
;LOGINS DISABLED - MULTI-USER SUPPORT 


+ 

FEATURE MASK DEFINITIONS (SECOND WORD) 


F2.DAS 
F2.LIB 
F2.MP= 
F2.EVT 
F2.ACN 
F2.SDW 
F2.POL 
F2.WND 
F2.DPR 
F2.IRR 
F2.GGF 
F2.RAS 
F2.AHR 
F2.RBN 
F2.SWP 
F2.STP 


= 'B'l 
= 'B'2 
'B ' 4 
='B'10 
='B'20 
=’B'40 
B'100 
= 'B ' 200 
= 'B ' 400 
= 'B'1000 
='B'2000 
='B'4000 
= 'B'10000 
= 'B'20000 
= 'B 1 40000 
= 'B ' 100000 


KERNEL DATA SPACE SUPPORTED 

SUPERVISOR MODE LIBRARIES SUPPORTED 

SYSTEM SUPPORTS MULTIPROCESSING 

SYSTEM SUPPORTS EVENT TRACE FEATURE 

SYSTEM SUPPORTS CPU ACCOUNTING 

SYSTEM SUPPORTS SHADOW RECORDING 

SYSTEM SUPPORTS SECONDARY POOLS 

SYSTEM SUPPORTS SECONDARY POOL FILE WINDOWS 

SYSTEM HAS A SEPARATE DIRECTIVE PARTITION 

INSTALL, RUN, AND REMOVE SUPPORT 

GROUP GLOBAL EVENT FLAG SUPPORT 

RECEIVE/SEND DATA PACKET SUPPORT 

ALT. HEADER REFRESH AREA SUPPORT 

ROUND ROBIN SCHEDULING SUPPORT 

EXECUTIVE LEVEL DISK SWAPPING SUPPORT 

EVENT FLAG MASK IS IN THE TCB(1=YES) 


THIRD FEATURE MASK SYMBOL DEFINITIONS 


F3.CRA='B’l 
F 3.XCR='B 1 2 
F3.EIS= 1 B'4 
F 3.STM='B'10 
F3.UDS='B’20 
F3.PRO='B'40 
F3.XHR='B'100 


F 3.AST='B'200 
F3.11S='B'400 
F3.CLI='B'1000 
F3.TCM='B'2000 
F 3. PMN ='B 1 4 0 0 0 
F3.WAT='B'10000 
F3.RLK='B'20000 
F3.SHF='B'40000 



SYSTEM SPONTANEOUSLY CRASHED (1=YES) 
SYSTEM CRASHED FROM XDT (1=YES) 

SYSTEM REQUIRES EXTENDED INSTRUCTION SET 
SYSTEM HAS SET SYSTEM TIME DIRECTIVE 
SYSTEM SUPPORTS USER DATA SPACE 
SYSTEM SUPPORTS SEC. POOL PROTO TCBS 
SYSTEM SUPPORTS EXTERNAL TASK HEADERS 
SYSTEM HAS AST SUPPORT 
RSX-11S SYSTEM 
MULTIPLE CLI SUPPORT 

SYSTEM HAS SEPARATE TERMINAL DRIVER POOL 
SYSTEM SUPPORTS POOL MONITORING 
SYSTEM HAS WATCHDOG TIMER SUPPORT 
SYSTEM SUPPORTS RMS RECORD LOCKING 
SYSTEM SUPPORTS SHUFFLER TASK 
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HWDDF$ (Cont.) 


+ 

FOURTH FEATURE MASK BITS 


F4.CXD='B’l 
F4.XT='B'2 
F4.ERL='B’4 
F4.PTY='B'10 
F 4.DVN = 1 B'2 0 
F4.LCD='B'40 
F4.NIM='B'100 
F4.CHE='B'200 
F4.LOG='B 1 400 
F4.NAM='B'1000 
F4.FMP='B 1 2000 
F4.DCL='B'4000 
F4.DDS='B'10000 
F4.ACD='B'20000 


;COMM EXEC IS DEALLOCATED (NON-I/D ONLY) 

;SYSTEM IS AN XT SYSTEM (1=YES) 

;SYSTEM SUPPORTS ERROR LOGGING (1=YES) 

;SYSTEM SUPPORTS PARITY MEMORY (1=YES) 

;SYSTEM SUPPORTS DECIMAL VERSIONS (1=YES) 

;SYSTEM SUPPORTS LOADABLE CRASH (1=YES) 

;SYSTEM SUPPORTS DELETED TASK IMAGES (1=YES) 
;SYSTEM SUPPORTS DISK DATA CACHING (1=YES) 
;SYSTEM SUPPORTS LOGICAL NAMES (1=YES) 
;SYSTEM SUPPORTS NAMED DIRECTORIES (1=YES) 

;SYSTEM SUPPORTS FAST MAP DIRECTIVE 
;DCL IS DEFAULT CLI (1=YES) 

;NAMED DIRECTORY MODE IS THE DEFAULT (1=YES) 
; SYSTEM SUPPORTS ACD'S 


HARDWARE FEATURE MASK BIT DEFINITIONS 

HF.CIS,HF.FPP DEFINED AS SIGN BITS FOR RUN TIME SPEED 


;PROCESSOR HAS A UNIBUS MAP (1=YES) 

;PROCESSOR HAS EXTENDED INSTRUCION SET 
;SYSTEM HAS A QBUS (1=YES) 

;HARDWARE SUPPORTS DATA SPACE 

;PROCESSOR SUPPORTS COMMERCIAL INSTRUCTION SET 
} (l=PROC. HAS NO FLOATING POINT UNIT) 


HF.UBM= 1 B'1 
HF.EIS= 'B ' 2 
HF.QB='B ’ 4 
HF.DSP='B'10 
HF.CIS='B'200 
HF.FPP='B 1 100000 


SECOND HARDWARE FEATURE MASK BIT DEFINITIONS 
THIS WORD IS RESERVED FOR XT HARDWARE FEATURES 


H2.NVR='B'l 
H2.INV='B'2 
H2.CLK='B'4 
H2.ITF='B'10 

H2.PRO='B'20 
H2.BRG='B'100000 


;XT NON-VOLATILE RAM PRESENT (1=YES) 

;NON-VOLATILE RAM IS INVALID (1=YES) 

;XT CLOCK IS PRESENT (1=YES) 

;INVALID TIME FORMAT IN NON-VOLATILE RAM 
; (1=YES) 

;RUNNING ON PRO/3XX HARDWARE 
;XT BRIDGE MODULE PRESENT (1=YES) 


SYSGEN FEATURE SELECTIONS MASK. THIS IS INTENDED TO RECORD IN A 
BIT MASK THE CHOICES MADE AT SYSGEN TIME. FEATURES ARE LISTED HERE FOR 
OUR INFORMATIONAL PURPOSES ONLY. THEY CANNOT BE TESTED LIKE BITS IN THE 
FEATURE MASK SINCE THIS ONLY EXISTS IN THE RSX11M.STB FILE. NO BITS IN 
MEMORY ; ARE USED. THEY ARE ONLY INTENDED TO BE PRINTED FROM THE STB FILE 
BY CDA. 


SF.STD='B * 1 ;STANDARD EXEC SELECTED 

SF PGN =, B'2 ;SYSTEM WAS PRE—GENERATED 

; (EX. RL02/RC25 SYSTEM) 
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HWDDF$ (Cont.) 


+ 

MULTIPROCESSOR STATUS TABLE DEFINITIONS (TEMPORARY) 


MP.CRH='B'100000 
MP.PWF='B'40000 
MP.RSM='B'20000 
MP.NOP='B'10000 
MP.STP='B'4 
MP.INT='B'7777 

.MACRO HWDDF$ X,Y,Z 
. ENDM 
. ENDM 


;CRASH PROCESSOR IMMEDIATELY 
;POWERFAIL ON ONE CPU 
;RESET INTERRUPT MASKS 
;NOP FUNCTION FOR TRANSMISSION CHECK 
;STOP PROCESSOR IN ORDERLY FASHION 
;BIC MASK FOR INTERRUPT LVL FUNCTIONS 
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ITBDF$ 


.MACRO ITBDF$ L,B 


INTERRUPT TRANSFER BLOCK (ITB) OFFSET DEFINITIONS 


.IF DF 

A$$TRP 


.MCALL 

PKTDF$ 


PKTDF$ 

f 

DEFINE AST BLOCK OFFSETS 

. ENDC 

.ASECT 

.=0 

X.LNKt'L' .BLKW 

1 

LINK WORD FOR ITB LIST STARTING IN TCB 

X. JSR: 'L' JSR 

R5,@ 0 ; 

CALL $INTSC 

X.PSW:'L 1 .BLKB 

1 

LOW BYTE OF PSW FOR ISR 

. BLKB 

1 

UNUSED 

X.ISRr'L' .BLKW 

1 ? 

ISR ENTRY POINT (APR5 MAPPING) 

X.FORK:'L' 

f 

FORK BLOCK 

.BLKW 

1 ? 

THREAD WORD 

.BLKW 

1 

FORK PC 

• BLKW 

1 

SAVED R5 

.BLKW 

1 ? 

SAVED R4 

.IF DF 

M$$MGE 


X.REL: 1 L' .BLKW 

1 

RELOCATION BASE FOR APR5 

.ENDC 

X.DSI:'L' .BLKW 

i ; 

ADDRESS OF DIS.INT. ROUTINE 

X.TCB:'L' .BLKW 

l ; 

TCB ADDRESS OF OWNING TASK 

.IF NB 

SYSDEF 


.IF DF 

A$$TRP 


.BLKW 

i ; 

A.DQSR FOR AST BLOCK 

X.AST: 1 L' .BLKB 

A.PRM ; 

AST BLOCK 

.ENDC 

X.VEC:'L 1 .BLKW 

1 

VECTOR ADDRESS (IF AST SUPPORT, 


r 

THIS IS FIRST AND ONLY AST PARAMETER) 

X.VPC:'L' .BLKW 

1 ? 

SAVED VECTOR PC 

X.LEN:'L' 

f 

LENGTH IN BYTES OF ITB 

.ENDC 

.PSECT 

.MACRO 

ITBDF$ X,Y,Z 


. ENDM 

ITBDF$ 
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KRBDF$ 


.MACRO 


KRBDF$ 


CONTROLLER REQUEST BLOCK (KRB) 

THE CONTROLLER REQUEST BLOCK DEFINES THE ENVIRONMENT OF A DEVICE 
CONTROLLER. EXACTLY ONE KRB EXISTS FOR EVERY DEVICE CONTROLLER 

tfnnS“ 11M+ SYSTEM ‘ THE KRB STAINS CERTAIN^DEVICE^STATUS^ 
INCLUDING THE CSR AND VECTOR ADDRESS FOR THE CONTROLLER. 


;DEVICE DEPENDANT PARAMETER WORD 
CONTROLLER PRIORITY 
;INTERRUPT VECTOR ADDRESS 
CONTROLLER INDEX WITHIN THE SYSTEM 
CONTROLLER I/O COUNT 
CONTROLLER STATUS 

;ADDRESS OF CONTROL STATUS REGISTER 

THE ZERO OFFSET! 

;OFFSET TO UCB/UMR/RHBAE TABLE 
;HIGHEST PHYSICAL UNIT NUMBER 
;UNUSED BYTE 
;OWNER OF CONTROLLER 
CONTROLLER REQUEST QUEUE 
CONTROLLER UNIBUS RUN MASK 
;POSSIBLE KRB FORK BLOCK 




.ASECT 


.=177770 


177770 

K.PRM: 

.BLKW 

1 

177772 

K.PRI: 

• BLKB 

1 

177773 

K.VCT: 

. BLKB 

1 

177774 

K.CON: 

.BLKB 

1 

177775 

K.IOC: 

.BLKB 

1 

177776 

K.STS: 

.BLKW 

1 

000000 

K.CSR: 

.BLKW 

1 


r 

; NOTE: 

K.CSR 

MUST BE 

000002 

K.OFF: 

.BLKW 

1 

000004 

K.HPU: 

.BLKB 

1 

000005 


.BLKB 

1 

000006 

K.OWN: 

.BLKW 

1 

000010 

K.CRQ: 

.BLKW 

2 

000014 

K.URM: 

.BLKW 

1 

000016 

K.FRK: 

.BLKW 

1 


i 

; OFFSETS FOR 

THE KRB 


THE STARTING ADDRESS OF THE KRB. 


DEFINE OFFSETS IN SCB/KRB FOR DISK MSCP CONTROLLERS 

2 ;LIST HEAD FOR UMR WAITING ASSIGNMENT 

;BLK(S) 

1 COUNT OF AVAILABLE UMR WAITING 

;ASSIGNMENT BLOCK(S) 

1 ;OFFSET TO RHBAE REGISTER (IF ANY) 

; WHEN ONE ADDS (K.OFF) TO THE KRB ADDRESS, IT YIELDS AN 
;ADDRESS WHICH POINTS TO HERE. 

/ 

1 ;OFFSET TO UCB TABLE (IF KS.UCB SET) 



.=-20. 


177754 

KE.UMH: 

.BLKW 

177760 

KE.UMC: 

.BLKW 


.=177776 


177776 

KE.RHB: 

.BLKW 


000000 KE.UCB: .BLKW 
.PSECT 
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KRBDF$ (Cont.) 


CONTROLLER REQUEST BLOCK (KRB) STATUS BIT DEFINITIONS 


KS.OFL=l 
KS.MOF=2 
KS.UOP = 4 
KS.MBC=10 
KS.SDX=20 
KS.POE=40 
KS.UCB=100 
KS.DIP=200 
KS.PDF=400 

KS.EXT=1000 

KS.SLO=2000 


CONTROLLER OFFLINE (1=YES) 

CONTROLLER MARKED FOR OFFLINE (1=YES) 
;SUPPORTS OVERLAPPED OPERATION (1=YES) 

;DEVICE IS MASSBUS CONTROLLER (1=YES) 

;SEEKS ALLOWED DURING DATA XFERS (1=YES) 
;PARALLEL OPERATION ENABLED (1=YES) 

;UCB TABLE PRESENT (1=YES) 

;DATA TRANSFER IN PROGRESS (1=YES) 

;PRIVILEGED DIAGNOSTIC FUNCTIONS ONLY 
;BLOCK (S) (1=YES) 

;EXTENDED 22-BIT UNIBUS CONTROLLER 
,-BLOCK(S);(1=YES) 

CONTROLLER IS SLOW COMING ONLINE 
;BLOCK(S)(1=YES) 


r 

; DEFINE 

THE CONTIGUOUS 

/ 

.=177762 

.ASECT 


177762 S.PRI: 

. BLKB 

1 

177763 S.VCT: 

. BLKB 

1 

177764 S.CON: 

.BLKB 

1 

177765 

.BLKB 

1 

177766 

. BLKW 

1 

177770 S.CSR: 

.BLKW 

1 

177772 

.BLKW 

1 

177774 

.BLKB 

1 

177775 

.BLKB 

1 

177776 S.OWN: 

.BLKW 

1 

• SUBCONTROLLER 

REQUEST 


CONTROLLER PRIORITY 
;INTERRUPT VECTOR ADDRESS 
CONTROLLER INDEX 


CONTROL AND STATUS REGISTER 


;DISTRIBUTED CNTBL 


THE SUBCONTROLLER REQUEST BLOCK DEFINES THE ENVIRONMENT OF A 
DEVICE SUBCONTROLLER. EXACTLY ONE KRBl EXISTS FOR EVERY DEVICE 
SUBCONTROLLER IN AN RSX-11M+ SYSTEM. 



.=-4 

.ASECT 

177774 

Kl.CON: 

.BLKB 

177775 


.BLKB 

177776 

KI.STS: 

.BLKW 

000000 

Kl.MAS: 

.BLKW 


f 

; NOTE: 

Kl.MAS 

000002 

Kl.OWN: 

.BLKW 

000004 

Kl.CRQ: 

.BLKW 

000010 

Kl.UCB: 

.PSECT 


1 

1 

1 

1 


;SUBCONTROLLER INDEX WITHIN THE SYSTEM 
;UNUSED BYTE 
;SUBCONTROLLER STATUS 
;UCB ADDRESS OF THE MASTER UNIT 


;OWNER OF SUBCONTROLLER 
;SUBCONTROLLER REQUEST QUEUE 
;START OF THE UCB TABLE (IF ANY) 
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LCBDFS 



MACRO 


LCBDF$ 


LOGICAL ASSIGNMENT CONTROL BLOCK 

THE LOGICAL ASSIGNMENT CONTROL BLOCK (LCB) IS USED TO 
ASSOCIATE A LOGICAL NAME WITH A PHYSICAL DEVICE UNIT. 
LOGICAL CONTROL BLOCKS ARE LINKED TO FORM THE LOGICAL 
ASSIGNMENTS OF A SYSTEM. LOGICAL ASSIGNMENTS CAN BE MADE 
ON A SYSTEM-WIDE OR LOCAL (TERMINAL) BASIS. 


.ASECT 

.=0 



000000 L.LNK: .BLKW 1 
000002 L.NAM: .BLKW 1 
000004 L.UNIT: .BLKB 1 
000005 L.TYPE: .BLKB 1 
000006 L.UCB: .BLKW 1 
000010 L.ASG: .BLKW 1 
000012 L.LGTH=.-L.LNK 


LINK TO NEXT LCB 

LOGICAL NAME OF DEVICE 

LOGICAL UNIT NUMBER 

TYPE OF ENTRY (0=SYSTEM WIDE) 

TI UCB ADDRESS 

ASSIGNMENT UCB ADDRESS 

LENGTH OF LCB 


PSECT 
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MTADFS 


.MACRO 

.ASECT 


MTADF$,L,B 


ANSI MAGTAPE SPECIFIC DATA STRUCTURES 

VOLUME SET CONTROL BLOCK OFFSET DEFINITIONS (VSCB) 


; VOLUME SET AND 
} 

PROCESS 

CONTROL SECTION 

• =o 

V.TCNT:’L 

.BLKW 

1 

TRANSACTION COUNT 

V.TYPE: 'L 

.BLKB 

1 

;VOLUME TYPE DESCRIPTOR 

V.VCHA:'L 

• BLKB 

1 

;VOLUME CHARACTERISTICS 

V.LABL:'L 

.BLKB 

12. 

;FILE SET ID (FIRST SIX BYTES) 

V.NXT:'L' 

.BLKW 1 


;PTR TO NEXT VSCB NODE 

V.MVL:'L' 

•BLKW 1 


;PTR TO MOUNTED VOL LIST 

V.UVL:'L' 

•BLKW 1 


;PTR TO UNMOUNTED VOL LIST 

V.ATL:'L' 

.BLKW 1 


;ATL ADDR OF ACCESSING TASK 
; TCB IN RSXllM 

V.UCB:'L' 

.BLKW 1 


;ADDR OF CURRENT UCB OR PUD 

V.RVOL:'L 

.BLKB 

1 

.-CURRENT RELATIVE VOL # 

V.MOU:'L' 

.BLKB 1 


.-MOUNT MODE BYTE 

V.TCHR:'L 

' .BLKW 

1 

;UINT CHAR. FOR ALL UNITS USED FOR VOL 

V.SEQN: 'L 

' .BLKW 

1 

.-CURRENT FILE SEQUENCE # 

V.SECN:'L 

' .BLKW 

1 

.-CURRENT FILE SECTION # 

V.TPOS:'L 

' .BLKB 

1 

.-POSITION OF TAPE IN TM 1 S TO NXT HDR1 

V.PSTA:'L 

' .BLKB 

1 

.-PROCESS STATUS BYTE 

V.TIMO:'L 

' .BLKW 

1 

.-BLOCKED PROCESS TIMEOUT COUNTER 

V.STAT: 'L 

' .BLKW 

3 

.- STATUS WORDS USED BY COMMAND 
.-EXECUTION MODULES 

V.TRTB:'L 

' .BLKB 

1 

;TRANSLATION CONTROL BYTE 

V.EFTV:'L 

' .BLKB 

1 

.-FOR MAG TO RETURN IE.EOF. EOT. EOV 

t 

; LABEL DATA SECTION 


V.BLKL:'L 

' .BLKW 

1 

.-BLOCK LENGTH 

V.RECL: 'L 

' .BLKW 

1 

.-RECORD LENGTH 

V.FNAM:'L 

' .BLKW 

3 

.-FILE NAME 

V.FTYP:'L 

' .BLKW 

1 

.-FILE TYPE 

V.FVER:'L 

' .BLKW 

1 

.-FILE VERSION # 

V.CDAT:'L 

' .BLKW 

2 

.-CREATION DATE 

V.EDAT:'L 

' .BLKW 

2 

;EXPRIATION DATE 

V.BLKC:'L 

' .BLKW 

2 

.-BLOCK COUNT FOR FILE SECTION 

V.RTYP: 'L 

' .BLKB 

1 

;RECORD TYPE 

V.FATT: 'L 

' .BLKB 

1 

.-FILE ATTRIBUTES FOR CARRIAGE CONTROL 


.BLKB 

30. 

;REMAINDER OF FILE ATTRIBUTES 

; NULL WINDOW SECTION 


t 

V.WIND:'L 

' .BLKW 

4. 

.- NULL WINDOW 

V.MST2: 'L 

' .BLKW 

1 

;MAGTAPE STATUS BITS 

V.FABY:'L 

' .BLKB 

1 

;FILE ACCESSIBILITY BYTE (HDR1) 


V.ANSN:'L' 
V.BOFF:'L' 
V.DENS:'L' 
V.DRAT:'L' 
V.DBLK:'L' 
V.DREC: 'L' 
S.VSCB='B' 


.BLKB 1 
•BLKB 17 
• BLKB 
.BLKB 
.BLKB 
.BLKW 
. BLKW 


SPARE 

ANSI 17 CHARACTER FILE NAME 
BUFFER OFFSET 
REQUESTED UNIT DENSITY 
DEFAULT RECORD ATTRIBUTES 
DEFAULT BLOCK SIZE 
DEFAULT RECORD SIZE 
SIZE OF VSCB 
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.PSECT 

7 

; DEFINE OFFSETS INTO NULL WINDOW SECTION 
.ASECT 

.=0 

W.CTL:'L'.BLKW 1 ;CONTROL WORD IN WINDOW 

V.WINC='B'V.WIND+W.CTL ; CNTRL WORD IN NULL WINDOW 

.PSECT 


. =0 


; RELATIVE TO THE VSCB 

MOUNTED VOLUME LIST OFFSET DEFINITIONS (MVL) 

.ASECT 

.IF DF R$$11M 


M.NXT:'L' .BLKW 1 


. ENDC 


;PTR TO NXT MVL NODE (11M) 


M.UIC:'L' .BLKW 1 
M.CH:'L' .BLKW 1 
M.PROT:'L' .BLKW 1 


;OWNER UIC FROM RVOL #1 
; U.CH/U.VP (11D) 

;PROTECTION U.AR IN 11D 


.IF NDF R$$11M 



M.NXT:'L' 


M.RVOL:'L' 
M.STAT:'L' 
M.VIDP:'L' 
M.UCB:'L' 


.BLKW 2 
.BLKW 1 
.ENDC 
.BLKB 1 
.BLKB 1 
.BLKW 1 
.BLKW 1 


; ACP WORDS 11D 
;PTR TO NEXT MVL NODE (11D) 


;RELATIVE VOL # OF MOUNTED 
;VOLUME STATUS 
;VOLUME ID POINTER 
; ADDR OF ASSOC UCB OR PUD 


VOLUME 


S,MVL='B'. 


;SIZE OF MVL NODE 


.PSECT 

UNMOUNTED VOLUME AND VOLUME LIST OFFSET DEFINITIONS (UVL) 


.ASECT 


.=0 


L.NXT:'L' 

.BLKW 1 

; PTR 

TO NXT UVL NODE 


L.VOL1:'L' 

.BLKB 1 

; REL 

VOL # OF l'ST VOL 

IN NODE 

L.VOL2:'L' 

.BLKB 1 

; REL 

VOL # OF 2'ND VOL 

IN NODE 

L.VIDl:'L' 

•BLKB 6 

; VOL 

ID OF l'ST VOL IN 

NODE 

L.VID2:'L' 

.BLKB 6 

; VOL 

ID OF 2'ND VOL IN 

NODE 

S.UVL='B'. 


;SIZE OF UVL NODE 



•PSECT 

7 

; SYSTEM DATA STRUCTURE CONTENT VALUES 

r 

; VSCB VALUES 
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; V.MOU 

VALUES 



VM.OLD 

= 1 B 1 

200 

;OLD .FL300 VOLUME — VM.BYP WILL ALSO BE 

VM.BYP 

= 'B' 

100 

;BYPASS LABEL PROCESSING 

VM.ULB 

= * B 1 

40 

;UNLABELED TAPE 

VM.FSC 

= 1 B 1 

20 

;OVERRIDE FILE SET ID CHECK 

VM.EXC 

= 1 B 1 

10 

;OVERRIDE EXPRIATION DATE CHECK 

; V.MST2 

! VALUES 



V2.INI 

= 1 B 1 

1 

;MAG WANTS US TO INITIALIZE NEXT OUTPUT 

V2.XH2 

= 'B 1 

2 

;THIS FILE HAS NO HDR2, DON'T WRITE EOF2 

V2.XH3 

= 1 B * 

4 

;THIS FILE HAS NO HDR3, DON'T WRITE EOF3 

V2.NH3 

= 1 B 1 

10 

;DON'T WRITE HDR3/EOX3 LABELS 

V2.OAC 

= * B 1 

20 

;OVERRIDE FILE/VOLUME ACCESIBILITY 


; V.PSTA VALUES - UNBLOCKED TRANSITION STATE 


VP.RM 

= 

1 B 1 

2 

;READ DATA MODE 

VP.WM 

= 

*B 1 

4 

;WRITE DATA MODE 

VP.UCM 

= 

'B' 

6 

;UNLABELLED CREATE POSITIONING MODE 

VP.SM 

= 

*B 1 

10 

;SEARCH MODE 

VP.MOU 

= 

1 B 1 

20 

;MOUNT MODE 

VP.RWD 

= 

1 B 1 

40 

;REWIND OR VOL VERIFICATION WAIT 

VP.VFY 

= 

'B' 

VP.RWD 


VP.POS 

= 

1 B 1 

100 

;PROCESS IN POSITIONING MODE 


; (MULTI-SECTION FILE) 


BLOCKED STATE = -(UNBLOCKED TRANSITION STATE VALUES) 

PROCESS TIMED OUT BIT 0=1 
VP.TO='B'1 


; NULL 

WINDOW 

CONTROL BIT 

DEFINITIONS 



WI.RDV 

= 1 B 1 

400 

;ACCESSED 

FOR 

READ 

WI.WRV 

= * B 1 

1000 

;ACCESSED 

FOR 

WRITE 

WI.EXT 

= 'B ' 

2000 

;ACCESSED 

FOR 

EXTEND 

WI.LCK 

= * B 1 

4000 

;LOCKED 




; MVL VALUES 

IN THE 

M.STAT 

FIELD 

MS.VER 

= 1 B 1 

200 


;VOL ID NOT VERIFIED 

MS.RID 

= * B 1 

1 


;VOL ID TO BE READ NOT CHECKED 

MS.NMO 

= 1 B 1 

2 


;MOUNT MESSAGE NOT GIVEN YET 

MS.TMO 

= 1 B 1 

4 


;ONE TIMEOUT ALREADY EXPRIED 

MS.EXP 

t 

= 1 B 1 

10 


;EXPIRATION DATE MESSAGE GIVEN 

; MISC 

BITS 

USED IN 

MOUNT 

(STORED IN V.STS) 

MO.OVR 

= 1 B 1 

1 


; OVER RIDE VOL NAME SWITCH 

MO.UIC 

= 1 B 1 

2 


; EXPLICIT UIC GIVEN 

MO.PRO 

= * B 1 

4 


; EXPLICIT PROTECTION GIVEN 

MO.160 

= 'B 1 

10 


; 1600 BPI SPECIFIED 


• ENDM 
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.MACRO OLRDF$ $$$GBL 


THIS MODULE DEFINES THE ONLINE RECONFIGURATION INTERFACE 
AS IMPLEMENTED BETWEEN THE RSX-11M-PLUS TASKS CON, HRC, AND 
THE RDDRV. 


DEFINE THE I/O FUNCTION CODES FOR ONLINE RECONFIGURATION CONTROL. 


.MCALL .WORD.,DEFIN$ 

.IF IDN <$$$GBL>,<DEF$G> 

...GBL=1 

.IFF 

...GBL=0 

. ENDC 


THE FOLLOWING MACRO DEFINES THE SUB-FUNCTION CODES FOR EACH OF THE 
OPERATIONS PERFORMED BY THE HRC TASK AND A PARAMETER DESCRIBING THE 
ARGUMENTS REQUIRED FOR EACH FUNCTION. IN A MACRO CALL THE FOLLOWING 
ARE THE LEGAL COMBINATIONS FOR THE 'MASK' PARAMETER: 

<> SIGNIFYING NO PARAMETERS 

<D> SIGNIFYING ONE BUFFER DESCRIPTOR 

<D,D> SIGNIFYING TWO BUFFER DESCRIPTORS 

<D,CT> SIGNIFYING ONE DESCRIPTOR AND 'CT' 

BYTES OF PARAMETERS 

<CT> SIGNIFYING 'CT' BYTES OF PARAMETERS 


•MACRO FUNC NAME,SUBF,FUN,MASK 

.WORD. 10.'NAME,SUBF,FUN 
FUNCA NAME,<MASK> 

. ENDM 

.MACRO FUNCA NAME,MSK 
PARCT=0 
DESCT=0 
.IRP X,<MSK> 

.IIF IDN <X>,<P> PARCT=PARCT+1 
.IIF IDN <X>,<D> DESCT=DESCT+1 

.IIF GT <PARCT-17> .ERROR INVALID PARAMETER COUNT 
.IIF GT <DESCT-17> .ERROR INVALID DESCRIPTOR COUNT 
.ENDR 

TEMP=<DESCT*4 > + <PARCT*2> 

.WORD. 10$'NAME,<<DESCT*20+PARCT>>,TEMP 
.ENDM 


DEFINE ONLINE RECONFIGURATION I/O FUNCTIONS 


.WORD. 10.MFC,000,001 
.WORD. 10.RSC,000,002 
.WORD. 10.WSC,000,006 


MULTI-FUNCTION MODIFY CONFIGURATION 


READ SYSTEM CONFIGURATION 
MODIFY DEVICE CONFIGURATION 
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DEFINE SUBFUNCTIONS TO MODIFY DEVICE. CONFIGURATION 


FUNC 

FUNC 

FUNC 

FUNC 

FUNC 

FUNC 

FUNC 

FUNC 

FUNC 

FUNC 

FUNC 

FUNC 

FUNC 

FUNC 

FUNC 

FUNC 

FUNC 


ONL,001,006,<D,D> 

OFL,002,006,<D,D> 

MAI,003,006,<D,D> 

CAC,004,006,0 
MEM,005,006,0 
STN,006,006,<P,P> 

HRC,007,006,<P,P> 

ONE,010,006,<P,P> 

STA,011,006,<D> 

IF ,012,006,<P,P> 

RLI,013,006,<D,D,D,D> 
RUL,014,006,<D,D,D,D> 
MBO,015,006,<P,P,D,D,D,D 


SET DEVICE ONLINE 

SET DEVICE OFFLINE 

SET DEVICE IN MAINTAINENCE MODE 

CACHE CONTROL 

MIND CONTROL 

RECONFIGURATION CONTROL, 

SPECIFY TASK NAME 
RECONFIGURATION CONTROL, 

HRC OPERATING MODE 
ON <CONDITION> <COMMAND> 

RETURN DEVICE STATE 
IF <CONDITION> <COMMAND> 

LINK UNIBUS RUN 
UNLINK UNIBUS RUN 
D,D,D,D> ; MEMORY BOX ONLINE 


RSW,016,006,<D,D,D,D> 
WAT,017,006,<D> 

RAT,020,006,<D,D> 


SWITCH BUS 
WRITE ATTRIBUTES 
READ ATTRIBUTES 


MBF,021,006,<P,P,D,D,D,D,D,D,D,D> ; MEMORY BOX OFFLINE 


IO$MAX=21 


DEFINE MAXIMUM SUBFUNCTION 


DEFIN$ IS•HRG,6• ; STOP PROCESSING CONDITION ENCOUNTERED 

; SECOND STATUS WORD IS ARGUMENT 


DEFINE A MACRO, WHICH WHEN EXPANDED WITH THE APPROPRIATE DEFINITION 
FOR .IOER• WILL DEFINE THE PRIVATE ERROR CODES USED BY HRC AND CON. 

.MACRO OLREM$ 


$$$VAL=-256. 


DEFINE INITIAL ERROR NUMBER VALUE 


.IOER. 
.IOER. 
.IOER. 
.IOER. 
.IOER. 
.IOER. 
.IOER. 
.IOER. 
.IOER. 
.IOER. 
.IOER. 
.IOER. 
.IOER. 
.IOER. 
.IOER. 
.IOER. 
.IOER. 
.IOER. 
.IOER. 
.IOER. 
.IOER. 
.IOER. 


IE$DAL,<DEVICE already linked> 

IE$DNL,<DEVICE not linked> 

IE$PRM,<Parameter error> 

IE$SYN,<Syntax error> 

IE$AFE,<Attribute format error> 

IE$TMU,<HRC... Internal tables insufficient for this system> 
IE$CAB,<Unable to access busrun> 

IE$TRP,<HRC... internal addressing error> 

IE$ALG,<Memory box parameter error> 

IE$TQU,<Timeout on unit quieting operation> 

IE$EPO,<ONLINE CPU failure> 

IE$EUO,<ONLINE UNIT failure> 

IE$ECO,<ONLINE CONTROLLER failure> 

IE$EPF,<OFFLINE CPU failure> 

IE$EUF,<OFFLINE UNIT failure> 

IE$ECF,<OFFLINE CONTROLLER failure> 

IE$CFU,<Attempt to quiet unit for controller failed> 

IE$CSR,<CSR for controller not present in I/O page> 

IE$SWF,<Unable to switch unit away from current controlled 
IE$ICE,<HRC... detected I/O database consistancy error> 

IE$SCE,<Executive or Driver status change error> 

IE$MDE,<HRC... Memory descriptor format error> 
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.IOER. 
.IOER. 
.IOER. 
.IOER. 
.IOER. 
.IOER. 
.IOER. 
.IOER. 
.IOER. 
.IOER. 
.IOER. 
.IOER. 
• ENDM 


IE$NFW, 
IE$CXT, 
IE$IDU, 
IE$UNK , 
IE$SZE / 
IE$POB r 
IE$NLB, 
IE$OMP , 
IE$POC , 
IE$DFE , 
IE$IDS , 
IE$UOE t 


<No path to target device is available> 

<Unable to take unit with context offline.> 

<Invalid device descriptor> 

<Device is unknown in this configuration> 

<HRC... Unable to access device to size drive> 

Can't take box offline. Partition overmaps box> 
Can't take box offline. Not last box in memory> 
Can't modify partition size. Overmap exists> 
Can't modify partition size. Occupied> 

Request format error.> 

Invalid device specification^ 

Unkown error from online/offline call> 


<HRC. 
<HRC • 
<HRC • 
<HRC • 
<HRC • 
<HRC • 
<HRC • 


CONDITION CODES FOR CONDITIONS TESTED BY 10.ONE AND 10.IF FUNCTIONS 


C0$0NL = 1 
C0$0FL = 2 
C0$UNK = 3 
C0$ACC = 4 
CO$ANY = 5 
C0$MAI = 6 


; IF DEVICE NOW ONLINE 
; IF DEVICE NOW OFFLINE 
; UNKNOWN DEVICE 

; ACCESSABLE (ACCESS PATH EXISTS) 
; ANY ERROR CONDITION 
; MAINTENANCE MODE 


C0$MAX = 6 


MAXIMUM CODE 


CONDITION COMMAND CODES FOR 10.ONE AND 10.IF FUNCTIONS 


CD$STO = 2 
CD$GOT = 4 
CD$CON = 6 


? 'STOP' COMMAND 
; 'GOTO' 

; 'CONTINUE' 


CD$MAX = 6 


MAXIMUM CONDITION DEFINED 


ARGUMENT DEFINITION FOR IO.HRC FUNCTION 


M$LOG = 1 
M$INIT = 2 
M$DEBG = 4 
M$EXIT = 10 


SUPRESS CONFIGURATION TRANSMISSION TO ERRLOG 
INITALIZE HRC 

SET HRC INTO DEBUG MODE. (DEVELOPMENT ONLY) 
EXIT REQUEST (FROM ABORT AST REQUEST) 


DEFINE TABLE OFFSETS AND STATUS BITS RETURNED IN RESPONSE TO 
A 'READ CONFIGURATION' QIO 


.ASECT 

.=0 

C$DTYP: .BLKB 1 ; ENTRY TYPE FIELD 


ENTRY TYPE CODES ARE AS FOLLOWS 
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ET$HDR 

= 1 

; CONFIGURATION HEADER ENTRY 


ET$END 

= 2 

; END OF CONFIGURATION DATA 


ET$DEV 

= 'A 

; MINIMUM VALUE FOR DEVICE SPECIFICATION 




; ENTRY 

C$DECT: 

• BLKB 

1 

; COUNT OF TABLE ENTRIES (CPUS+SWITCHED 




; BUS RUNS+CONTROLLERS+UNITS) 

C$DVER: 

. BLKB 

1 

; VERSION OF RECONFIGURATION TASK PROTOCAL 

C$DSTD: 

.BLKB 

1 

; SIZE OF HEADER 

C$DMUB: 

.BLKB 

1 

; MAXIMUM UNIBUS RUNS SUPPORTED 

C$DMCT: 

.BLKB 

1 

; MAXIMUM CONTROLLERS OF A GIVEN TYPE 




; SUPPORTED 


.EVEN 



C$DFAC: 

.BLKW 

2 

; FACILITES SUPPORTED IN HOST SYSTEM 

C$DIDN: 

.BLKW 

9. 

; HRC VERSION AND BUILD TIMESTAMP 

C$STD: 



; SIZE OF THE TABLE HEADER 


OFFSETS WITHIN THE FIXED PORTION OF A GIVEN ENTRY 



.=0 




C$DTYP: 



ENTRY TYPE CODE 


C$DNAM: 

.BLKW 

1 

TWO ASCII CHARACTER UNIT OR 

CONTROLLER NAME 

C$DPUN: 

.BLKB 

1 

CONTROLLER NUMBER (0-255.) 


C$DLUN: 

.BLKB 

1 

LOGICAL UNIT NUMBER IF THIS 

DEVICE IS A UNIT 

C$DSCT: 

.BLKB 

1 

SUB-CONTROLLER NUMBER 


C$DEVT: 

.BLKB 

1 

DEVICE TYPE CODE 


C$DSTS: 

.BLKW 

1 

DEVICE STATUS MASK 


; FLAG 

VALUES 

FOR C$DSTS 




CS$ATR=1 

CS$EXF=76 

CS$SUB=100 

;CS$XXX=200 

CS$OFL=400 

CS$PDF=1000 

CS$POR=2000 

CS$MBD=4000 

CS$UNK=10000 

CS$ACC=20000 

CS$MTD=40000 

CS$DRV=100000 


VARIABLE LENGTH ATTRIBUTE INFO IS APPENDED 
FIELD IN C$DSTS CONTAINING COUNT OF ADDITIONAL 
BYTES IN THIS DEVICE ENTRY 
THIS IS A SUB-CONTROLLER DEVICE 
UNUSED 

1=>DEVICE IS OFFLINE, 0=>DEVICE IS ONLINE 
DEVICE IS RESTRICTED TO PRIVILEGED DIAG FNS 
THIS IS A MULTIPORT DEVICE 
DEVICE IS A MASS BUS DEVICE 
DEVICE IS UNKNOWN 

AN ONLINE ACCESS PATH EXISTS TO THIS DEVICE 
DEVICE IS MOUNTED (DISK) OR LOGGED IN (TERM) 

A DRIVER IS LOADED FOR THIS DEVICE 


C$DST2: . BLKW 1 


STATUS EXTENSION 


CS$PUN=20 

CS$CRD=40 

CS$PRC=100 

CS$CTL=200 

CS$DCL=3400 


1=> THIS DEVICE SPECIFIED WITH PHYSICAL 
UNIT NUMBER 

1=> THIS IS A CONTROLLER RELATIVE DEVICE SPEC 
1=> THIS IS A PORT RELATIVE CONTROLLER SPEC 
DEVICE IS A CONTROLLER (MUST BE SIGN BIT) 
DEVICE CLASS CODE FIELD. MUST BE LOW ORDER 
BIT OF HIGH BYTE. 
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DEVICE CLASS VALUES 


DC$UNI = 0 
DC$CTL = 1 
DC$MKU = 2 
DC $M KC = 3 
DC$SBU = 4 
DC$SBC = 5 
DC$CPU = 6 
;DC$XXX = 7 


UNIT 

CONTROLLER 

MEMORY BOX UNIT 

MEMORY BOX CONTROLLER 

SWITCHED BUS UNIT 

SWITCHED BUS CONTROLLER 

CPU 

UNUSED 


C$DDAT: .BLKW 2 
C$SME: 


DEVICE DEPENDANT DATA 
SIZE IF A MINIMUM ENTRY 


VARIABLE PORTION OF A GIVEN ENTRY 


; FOR CONTROLLERS 

t 

. =C$SME 

C$DKPO: .BLKW 1 


C$SCT: 


; PORT-STATUS-WORD. THIS DESCRIBES THE BUS RUN 
; CPU OR SWITCHED BUS, TO WHICH THIS 
; CONTROLLER IS CONNECTED. 

; MIMIMUM SIZE OF A CONTROLLER ENTRY 


FOR UNIT ENTRIES 


.=C$SME 

C$DCTN: .BLKW 1 

C$DUPO: .BLKW 1 

C$SUN: 


CONTROLLER NAME. TWO CHARACTER ASCII CODE 
OF THE CONTROLLER TO WHICH THIS UNIT IS 
ATTACHED. 

PORT-STATUS-WORD. THIS IS THE 

FIRST OF THE PSWS DESCRIBING THE CONTROLLER(S) 
TO WHICH THIS UNIT IS CONNECTED. 

MIMIMUM SIZE OF A UNIT ENTRY 


FOR CPU-S 


.=C$SME 

C$DCPO: .BLKW 1 
C$SCP: 

} 

? FOR MEMORY BOXES 


; PORT-STATUS-WORD. THIS IS THE 
; NUMBER FOR THIS CPU. 

; MINIMUM SIZE OF A CPU ENTRY 


BUS 
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.=C$SME 

C$DCTN: .BLKW 1 
.BLKW 4 

C$SMB: ; MAXIMUM SIZE OF A MEMORY BOX ENTRY 


; CONTROLLER NAME. 

; MAXIMUM OF 4 PORTS FOR MEMORY CONTROLLERS 


STATUS BIT DEFINITIONS FOR THE PORT STATUS WORD 


CP$OFL = 4 00 

CP$XXX=1000 

CP$CUR=2000 

CP$XXX=4000 

CP$XXX=10000 

CP$ACC=20000 

CP$MTD=40000 

CP$XXX=100000 


1=> PORT IS OFFLINE 
UNUSED 

THIS PORT IS THE CURRENT PORT (S•KRB 

REFERENCES THIS PORT 

UNUSED 

UNUSED 

THIS PORT HAS AN ACCESS PATH 

PORT HAS CONTEXT OR SERVICES A DEVICE HAVING 

CONTEXT 

UNUSED 


DEVICE ATTRIBUTES CODES 


.MACRO ATT NAME,SIZ 
$$$TMP=$$$TMP+1 

DEFIN$ DA$'NAME,$$$TMP!<400*SIZ> 
. ENDM 


$$$TMP= 

0 

ATT 

CSR,2 

ATT 

VEC, 2 

ATT 

UBR, 2 

ATT 

TYP, 2 

ATT 

VOL,12 

ATT 

ERR,10 

ATT 

PRI, 2 

ATT 

MBP, 6 

ATT 

STE, 2 

ATT 

SAL, 2 

ATT 

DSN, 2 

ATT 

CSN,10 


MEMORY BOX ATTRIBUTE BUFFER 



.ASECT 

.=0 


C$MBAS: 

.BLKW 

1 

C$MINT: 

. BLKB 

1 


. BLKB 

1 

C$MSIZ: 

.BLKW 

1 

C$MGRN: 

.BLKW 

1 


CSR ADDRESS 
VECTOR ADDRESS 
UNIBUS RUN 

DEVICE TYPE, READ ONLY 
MOUNTED VOLUME NAME, READ ONLY 
DEVICE ERROR COUNTERS, READ/WRITE 
DEVICE INTERRUPT PRIORITY 
MEMORY BOX PARAMETER 
SANITY TIMER ENABLE/DISABLE 
ALARM ENABLE/DISABLE 
DEVICE SERIAL NUMBER 
CPU SERIAL NUMBERS 


BASE ADDRESS OF BOX 
INTERLEAVE FACTOR 
FREE BYTE 

SIZE OF BOX IN 32 WORD BLOCKS 
BOX GRANULARITY. "BYTES-PER-UNIT" 


C$MDSC: 


SIZE OF BOX ATTRIBUTE BUFFER 
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.PSECT 


REDEFINE MACRO TO NULL 


.MACRO OLRDF$ X 
. ENDM 

.MACRO ATT X 
.ENDM 

.ENDM 


MACRO FOR THE DEFINITION OF DEVICE TYPE CODES 


.MACRO DEVCD$ $$$GBL 
.MCALL DEFIN$ 

.IF IDN <$$$GBL> , <DEF$G> 

..•GBL=1 

.IFF 

...GBL=0 

• ENDC 

.MACRO DEV X 
DEFIN$ D$ 1 X,$$$TMP 
$$$TMP=$$$TMP+1 


.ENDM 


$$$TMP = 0 


DEV UDET 

; UNDETERMINED DEVICE TYPE 

DEV UKNO 

; UNKNOWN DEVICE TYPE 

DEV RKO3 

; RK03 

DEV RKO5 

; RK05 

DEV RK5F 

; RK05-F (DUAL DENSITY FIXED CARTRIDGE) 

DEV RX01 

; RX01 

DEV RX02 

; RX02 (DUAL DENSITY RX01) 

DEV RL01 

; RL01 

DEV RL02 ; 

; RL02 

DEV RP02 

RP02 

DEV RP03 

RP03 

DEV RP04 

RP04 

DEV RPO5 

RP05 

DEV RPO6 

RP06 

DEV RP07 

RP07 

DEV RK06 j 

; RK06 

DEV RK07 j 

; RK07 


C-53 













RSX-11M-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS 


OLRDF$ (Cont.) 


DEV RM02 ; 

RM02 

DEV RM03 ; 

RM03 

DEV RM05 ; 

RM05 

DEV RM80 ; 

RM80 

DEV RS03 ; 

RS03 

DEV RS04 ; 

RS04 (DUAL DENSITY RS03) 

DEV RF11 ; 

RF11/RS08 

DEV TK25 

TK25 

DEV TK50 

TK50 

DEV TU10 

TU10 

DEV TU16 

TU16 

DEV TU4 5 

TU45 

DEV TU77 

TU77 

DEV TU78 

TU78 

DEV TSI1 

TS11 

DEV TSUO 

TSUO 5 

DEV TSVO 

TSV05 

DEV TU80 

TU80 

DEV TU81 

TU81 

DEV TM02 ; 

TM02 

DEV TM03 ; 

TM03 

DEV TM78 ; 

TM78 

DEV TU56 ; 

TU56 

DEV TU58 ; 

TU58 

DEV TU60 ; 

: TU60 

DEV MSCP 

UDA50 

DEV RA60 

RA60 

DEV RA80 

RA80 

DEV RA81 

RA81 

DEV RC25 

RC25 (AZTEC) 

DEV RD50 ; 

: RD50 

DEV RD51 ; 

: RD51 

DEV RX50 ; 

: RX50 

DEV MLll ; 

: MLll 

DEV TERM ; 

; TERMINAL 

$$$TMP=370 


DEV USRO 

USER TYPE 0 

DEV USR1 

USER TYPE 1 

DEV USR2 

USER TYPE 2 

DEV USR3 

USER TYPE 3 

DEV USR4 

USER TYPE 4 

DEV USR5 

USER TYPE 5 

DEV USR6 

USER TYPE 6 

DEV USR7 

USER TYPE 7 


.MACRO DEVCD$ 
. ENDM 

.MACRO DEV X 
.ENDM 

.ENDM 
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PCBDF$ 


.MACRO PCBDF$ L,B 


; + 

; MAIN PARTITION PCB 


.ASECT 

.=0 

P.LNK:'L'.BLKW 1 
.BLKW 1 
P.NAM:'L'.BLKW 2 
P.SUB:'L'.BLKW 1 
P.MAIN:'L'.BLKW 1 
P.REL:’L'.BLKW 1 
P.BLKS:'L' 

P.SIZE:'L'.BLKW 1 
P.WAIT:'L'.BLKW 2 
.BLKW 2 
P.STAT:'L'.BLKW 1 
P.ST2:'L' .BLKW 1 
.BLKW 3 


;LINK TO NEXT MAIN PARTITION PCB 
;(UNUSED) 

;PARTITION NAME IN RAD50 
;POINTER TO FIRST SUBPARTITION 
;POINTER TO SELF 

;STARTING PHYSICAL ADDRESS IN 32W BLOCKS 

;SIZE OF PARTITION IN 32W BLOCKS 
;PARTITION WAIT QUEUE LISTHEAD 
; (UNUSED) 

;PARTITION STATUS FLAGS 

;STATUS EXTENSION FOR COMMON AND MAIN PCB'S 
;(UNUSED) 


P.HDLN:'L'.BLKB 1 
P.IOC:'L' .BLKB 1 


$$$ = . 


;SIZE OF EXTERNAL HEADER IN 32W BLOCKS 
;PARTITION I/O COUNT 


P.RRM:'L'.BLKW 1 


;REQUIRED RUN MASK 


.IF NDF M$$PRO 

.=$$$ 

. ENDC 


.IF NB SYSDEF 


P.LGTH='B 1 . 


.ENDC 


;PARTITION CONTROL BLOCK LENGTH 


+ 

TASK REGION PCB 


.=0 

P.LNK:’L'.BLKW 1 
P.PRI:'L'.BLKB 1 
P.RMCT:'L'.BLKB 1 
P.NAM:'L'.BLKW 2 
P.SUB:'L'.BLKW 1 
P.MAIN:'L'.BLKW 1 
P.REL:'L'.BLKW 1 
P.BLKS:'L' 


;UTILITY LINK WORD 

,-PRIORITY OF PARTITION 

;RESIDENT MAPPED TASKS COUNT 

;PARTITION NAME IN RAD50 

;POINTER TO NEXT SUBPARTITION 

;POINTER TO MAIN PARTITION 

;STARTING PHYSICAL ADDRESS IN 32W BLOCKS 
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PCBDF$ (Cont.) 


P.SIZE:'L'.BLKW 

1 

;SIZE OF PARTITION IN 32W BLOCKS 

.BLKW 

1 

; (UNUSED) 

P.SWSZ:'L'.BLKW 

1 

;PARTITION SWAP SIZE 

P.DPCB:'L'.BLKW 

1 

CHECKPOINT ALLOCATION PCB 

P.TCB:'L'.BLKW 

1 

;TCB ADDRESS OF OWNER TASK 

P.STAT:'L'.BLKW 

1 

;PARTITION STATUS FLAGS 

P.HDR:'L' .BLKW 

1 

;POINTER TO HEADER CONTROL BLOCK 

.BLKW 

1 

; (UNUSED) 

P.ATT:'L' .BLKW 

2 

;ATTACHMENT DESCRIPTOR LISTHEAD 

P.HDLN:'L'.BLKB 

1 

;SIZE OF EXTERNAL HEADER IN 32W BLOCKS 

P.IOC:'L' .BLKB 

1 

;PARTITION I/O COUNT 

$$$=. 

P.RRM:'L'.BLKW 

i 

;REQUIRED RUN MASK 

.IF NDF 

.=$$$ 

. ENDC 

M$$PRO 



; + 

; COMMON REGION 

PCB 


.=0 

P.LNK:'L'.BLKW 

1 

;UTILITY LINK WORD 

P.PRI:'L'.BLKB 

1 

;PRIORITY OF PARTITION 

P.RMCT:’L'.BLKB 

1 

;RESIDENT MAPPED TASKS COUNT 

P.NAM:'L'.BLKW 

2 

;PARTITION NAME IN RAD50 

P.SUB:'L'.BLKW 

1 

;POINTER TO NEXT SUBPARTITION 

P.MAIN:'L'.BLKW 

1 

;POINTER TO MAIN PARTITION 

P.REL:'L'.BLKW 

1 

;STARTING PHYSICAL ADDRESS IN 32W BLOCKS 

P.BLKS: 'L' 
P.SIZE:'L'.BLKW 

1 

; SI ZE OF PARTITION IN 32W BLOCKS 

P.CBDL:'L'.BLKW 

1 

;COMMON BLOCK DIRECTORY LINK 

P.CSBA:'L' 


; CACHE STATISTICS BLOCK LISTHEAD 
; ...(IF P2.CHE IS SET, PARTITION WON’T SWAP 

P..SWSZ: 'L' .BLKW 

1 

;PARTITION SWAP SIZE 

P.DPCB:'L'.BLKW 

1 

;POINTER TO DISK PCB 

P.OWN:'L' .BLKW 

1 

;OWNING UIC OF REGION 

P.STAT:’L'.BLKW 

1 

;PARTITION STATUS FLAGS 

P.ST2:'L' .BLKW 

1 

;STATUS EXTENSION FOR COMMON AND MAIN PCB'S 

P.PRO:'L 1 .BLKW 

1 

;PROTECTION WORD [DEWR,DEWR,DEWR,DEWR] 

P.ATT:'L' .BLKW 

2 

;ATTACHMENT DESCRIPTOR LISTHEAD 

P.HDLN:’L'.BLKB 

1 

; SIZE OF EXTERNAL HEADER IN 32W BLOCKS 

P.IOC:'L' .BLKB 

1 

;PARTITION I/O COUNT 

$$$=. 



P.RRM:'L'.BLKW 

1 

;REQUIRED RUN MASK 
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•IF NDF M$$PRO 

.=$$$ 

• ENDC 


.PSECT 

+ 

PARTITION STATUS WORD 


PS.OUT='B'100000 
PS.CKP='B'40000 
PS,CKR='B 1 20000 
PS.CHK=’B’10000 
PS.FXD='B'4000 
PS.CAF='B'2000 
PS.LIO='B'1000 
PS . NSF='B 1 400 
PS.COM='B 1 200 
PS.LFR='B’100 
PS.PER='B'40 
PS.NWB=’B'20 
PS.DEL='B'10 

PS.AST='B'4 

; + 

; REQUIRED RUN MASK 


PR.UBT='B'100000 
PR.UBS='B'40000 
PR.UBR='B'20000 
PR.UBP='B'10000 
PR.UBN='B'4000 
PR.UBM='B'2000 
PR.UBL=’B'1000 
PR.UBK='B 1 400 
PR.UBJ='B'200 
PR.UBH='B 1 100 
PR.UBF='B'40 
PR.UBE='B'20 
PR.CPD='B'10 
P R. C PC = ' B ' 4 
PR.CPB='B'2 
P R. C PA = ' B ' 1 

; + 

; STATUS EXTENSION WORD 
; (THESE BITS CAN 


PCBDF$ (Cont.) 


BIT DEFINITIONS 


;PARTITION IS OUT OF MEMORY (1=YES) 

;PARTITION CHECKPOINT IN PROGRESS (1=YES) 

;PARTITION CHECKPOINT IS REQUESTED (1=YES) 

;PARTITION IS NOT CHECKPOINTABLE (1=YES) 

;PARTITION IS FIXED (1=YES) 

;CHECKPOINT SPACE ALLOCATION FAILURE (1=YES) 
;MARKED BY SHUFFLER FOR LONG I/O (1=YES) 

;PARTITION IS NOT SHUFFLEABLE (1=YES) 

;LIBRARY OR COMMON BLOCK (1=YES) 

;LAST LOAD OF REGION FAILED (1=YES) 

;PARTIY ERROR OCCURED IN THIS REGION (1=YES) 

;COMMON SHOULDN'T BE WRITTEN BACK 
;PARTITION SHOULD BE DELETED WHEN NOT ATTACHED 
: (1=YES) 

;PARTITION HAS REGION LOAD AST PENDING 


;UNIBUS 

RUN 

T 

; UNIBCJS 

RUN 

S 

;UNIBUS 

RUN 

R 

;UNIBUS 

RUN 

P 

; UNIBUS 

RUN 

N 

; UNIBCJS 

RUN 

M 

;UNIBUS 

RUN 

L 

;UNIBUS 

RUN 

K 

;UNIBUS 

RUN 

J 

;UNIBUS 

RUN 

H 

;UNIBUS 

RUN 

F 

;UNIBUS 

RUN 

E 

;PROCESSOR D 


;PROCESSOR C 


?PROCESSOR B 


;PROCESSOR A 



BIT DEFINITIONS 

ONLY BE EXAMINED IN COMMON OR MAIN PCB'S) 
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PCBDF$ (Cont.) 


P2.LMA='B'40000 

P2.CPC='B'20000 
P2.CHE='B'10000 
P2.SEC='B 1 4000 

P2.PAR='B'2000 
P2.POL='B'1000 
P2.CPU='B'400 
P2.PIC='B'200 
P2.RON='B'100 
P2.DRV='B'40 
P2.APR='B'7 


;DON'T SHUFFLE,DELETE SPINDLE OR MUTILATE 
;THIS PARTITION 

;CPCR INITIATED CHECKPOINT PENDING 
;CACHE PARTITION 
;THIS IS RO SECTION OF MU TASK 
;WITH TCB IN SEC. POOL 

;THE FIXER TASK HAS HANDLED A PARITY ERROR 
;SECONDARY POOL PARTITION 
MULTIPROCESSOR CPU PARTITION 

;POSITION INDEPENDENT LIBRARY OR COMMON (1=YES) 
;READ-ONLY COMMON (1=YES) 

;DRIVER COMMON PARTITION (1=YES) 

;STARTING APR NUMBER MASK FOR NON-PIC COMMON 


+ 

CHECKPOINT FILE PCB 


.=0 

P.LNK:'L' 
P.UCB:'L' 
P.LBN:'L' 

P.SUB:'L' 
P.MAIN:'L' 
P.REL:’L' 
P.SIZE:'L' 
P.DLGH='B ' 


ASECT 

.BLKW 1 
BLKW 1 
BLKW 1 
BLKW 1 
BLKW 1 
.BLKW 1 
BLKW 1 
.BLKW 1 


;LINK WORD OF CHECKPOINT FILE PCB'S 
;UCB ADDRESS OF CHECKPOINT FILE DEVICE 
;HIGH PART OF STARTING LBN 
;LOW PART OF STARTING LBN 

;POINTER TO FIRST CHECKPOINT ALLOCATION PCB 
;MUST BE 0 (FOR $RLPR1) 

;CONTAINS 0 IF FILE IN USE, 1 IF NOT IN USE 
;SIZE OF CHECKPOINT FILE IN 256W BLOCKS 
;LENGTH OF ALL DISK PCB'S 


+ 

CHECKPOINT ALLOCATION PCB 


.=0 

.BLKW 4 

P.SUB:'L' .BLKW 1 
P.MAIN:'L' .BLKW 1 
P.REL:'L' .BLKW 1 
P.SIZE:'L' .BLKW 1 


;(UNUSED) 

;LINK TO NEXT CHECKPOINT ALLOCATION PCB 
;ADDRESS OF CHECKPOINT FILE PCB 
;RELATIVE POSITION IN FILE IN 256W BLOCKS 
;SIZE ALLOCATED IN 256W BLOCKS 


+ 

COMMON TASK IMAGE FILE PCB 


.=0 

P.FID1:'L' .BLKW 1 
P.UCB:'L' .BLKW 1 
P.LBN:'L' .BLKW 1 
.BLKW 1 

P.FID2:'L' .BLKW 1 
P.MAIN:’L'.BLKW 1 
P.REL:'L' .BLKW 1 
P.FID3:'L' .BLKW 1 


;FILE ID WORD FOR SAVE 

;UCB ADDRESS OF DEVICE ON WHICH COMMON RESIDES 
;HIGH PART OF STARTING LBN 
;LOW PART OF STARTING LBN 
;FILE ID WORD FOR SAVE 
;POINTER TO SELF 
;ALWAYS CONTAINS A 0 
;FILE ID WORD FOR SAVE 


+ 

ATTACHMENT DESCRIPTOR OFFSETS 
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PCBDF$ (Cont.) 


.ASECT 

.=0 


A.PCBL:'L 

•.BLKW 

1 

A.PRI:'L' 

• BLKB 

1 

A.IOC:'L' 

.BLKB 

1 

A.TCB:'L' 

.BLKW 

1 

A.TCBL: 'L 

'.BLKW 

1 

A.STAT:'L 

'.BLKB 

1 

A.MPCT: 'L 

'.BLKB 

1 

A.PCB:’L' 

.BLKW 

1 

A.LGTH='B 

i 



;PCB ATTACHMENT QUEUE THREAD WORD 
;PRIORITY OF ATTACHED TASK 
;I/O COUNT THROUGH THIS DESCRIPTOR 
;TCB ADDRESS OF ATTACHED TASK 
;TCB ATTACHMENT QUEUE THREAD WORD 
;STATUS BYTE 

;MAPPING COUNT OF TASK THRU THIS DESCRIPTOR 
;PCB ADDRESS OF ATTACHED TASK 
;LENGTH OF ATTACHMENT DESCRIPTOR 


r 

; ATTACHMENT DESCRIPTOR STATUS BYTE BIT DEFINITIONS 


•PSECT 

AS.PRO='B' 100 
AS.SBP='B' 20 
AS.RBP='B '40 
AS.DEL= 1 B' 10 
AS.EXT='B ' 4 
AS.WRT='B'2 
AS.RED='B'l 

•MACRO PCBDF$ X,Y,Z 
• ENDM 
. ENDM 




;A.TCB IS SEC POOL TCB BIAS (1=YES) 
;CACHE BYPASS REQUESTED 
;REQUEST TO NOT BYPASS CACHE 
;TASK HAS DELETE ACCESS (1=YES) 

;TASK HAS EXTEND ACCESS (1=YES) 

;TASK HAS WRITE ACCESS (1=YES) 

;TASK HAS READ ACCESS (1=YES) 
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PKTDF$ 


.MACRO PKTDF$,L,B 


; + 

; ASYNCHRONOUS SYSTEM TRAP CONTROL BLOCK OFFSET DEFINITIONS 


; SOME POSITIONAL DEPENDENCIES BETWEEN THE OCB AND THE AST CONTROL BLOCK 
; ARE RELIED UPON IN THE ROUTINE $FINXT IN THE MODULE SYSXT. 


.ASECT 

.=177774 

A.KSR5:'L' .BLKW 1 
A.DQSR:'L' .BLKW 1 
.BLKW 1 
A.CBL:'L' .BLKW 1 


A.BYT:'L' .BLKW 1 
A.AST:'L' .BLKW 1 
A.NPR:'L' .BLKW 1 
A.PRM:'L' .BLKW 1 
AS.FPA='B'1 
AS ,RCA='B'2 
AS.RRA='B'3 
AS.PEA='B ' 4 
AS.REA= 1 B'5 
AS.PFA='B ' 6 
AS.CAA='B'7 


SUBROUTINE KISAR5 BIAS (A.CBL=0) 

DEQUEUE SUBROUTINE ADDRESS (A.CBL=0) 

AST QUEUE THREAD WORD 

LENGTH OF CONTROL BLOCK IN BYTES 

IF A.CBL = 0, THE AST CONTROL BLOCK IS 

TO BE DEALLOCATED BY THE DEQUEUE SUBROUTINE 

POINTED TO BY A.DQSR MAPPED VIA APR 5 

VALUE A.KSR5. THIS IS CURRENTLY USED ONLY 

BY THE FULL DUPLEX TERMINAL DRIVER FOR 

UNSOLICITED CHARACTER ASTS. 

IF THE LOW BYTE OF A.CBL = 0, AND THE 
HIGH BYTE IS NOT = 0, THE AST CONTROL BLOCK 
IS A SPECIFIED AST, WITH LENGTH, C.LGTH. 

IF THE HIGH BYTE OF A.CBL=0 
AND THE LOW BYTE > 0, THEN 
THE LOW BYTE IS THE LENGTH OF THE 
AST CONTROL BLOCK. 

IF HIGH BYTE = 0 AND LOW BYTE IS NEGATIVE, 

THEN THE BLOCK IS A KERNEL AST 

BIT 6 IS SET IF $SGFIN SHOULD 

NOT BE CALLED PRIOR TO DISPATCHING 

THE AST, AND THE LOW SIX BITS (5-0) 

REPRESENT THE INDEX/2 INTO THE 

KERNEL AST DISPATCH TABLE ($KATBL) 

NUMBER OF BYTES TO ALLOCATE ON TASK STACK 

AST TRAP ADDRESS 

NUMBER OF AST PARAMETERS 

FIRST AST PARAMETER 

CODE FOR FLOATING POINT AST 

CODE FOR RECEIVE DATA AST 

CODE FOR RECEIVE BY REFERENCE AST 

CODE FOR PARITY ERROR AST 

CODE FOR REQUESTED EXIT AST 

CODE FOR POWER FAIL AST 

CODE FOR CLI COMMAND ARRIVAL AST 


; BIT VALUES IN A.PRM+5 

AF.XCC='B 1 1 
AF.NOT='B'2 
AF.OOB='B'4 
AF.AST='B'10 
AF.ESQ= 1 B'20 
AF.LCK='B'40 
AF.QUE='B'100 
AF.MDE='B'200 


;ATTACHED FOR ALL BUT CONTROL-C (TF.XCC) 

,-ATTACHED FOR ALL NOTIFICATION (TF.NOT) 

;ACB IS FOR OUT-OF-BAND AST 

;ACB HANDLES UNSOL.INPUT CHAR AST'S (TF.AST) 
;ATTACHED FOR ESCAPE SEQUENCES (TF.ESQ) 

;ACB IS LOCKED 
;ACB IS QUEUED 
;ACB IS MARKED FOR DELETE 
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PKTDF$ (Cont.) 


ABORTER SUBCODES FOR ABORT AST (AS.REA) TO BE RETURNED ON USER'S STACK 


AB.NPV='B 1 1 
AB.TYP= 'B ' 2 

A.PLGH='B'70 
A.DUCB='B 1 10 
A.DLGH='B 1 10. 


;ABORTER IS NONPRIVILEGED (1=YES) 

;ABORT FROM DIRECTIVE (0=YES) 

;ABORT FROM CLI COMMAND (1=YES) 

;SIZE OF PARITY ERROR AST CONTROL BLOCK 
;UCB OF TERM ISSUING DEBUG COMMAND 
;LENGTH OF DEBUG (AK.TBT) AST BLOCK 


KERNEL AST CONTROL CODES (A.CBL) 


AK.BUF='B’200 


AK.OCB='B'201 
AK.GBI=’B'202 
AK.TBT='B'203 
AK.DIO='B'204 
AK.GGF= 1 B'205 


;BUFFERED I/O COMPLETION 
;THIS CODE MUST BE 200 UNTIL ALL 
;REFERENCES IN TTDRV ARE FIXED 
;OFFSPRING TASK EXIT 
SEGMENTED BUFFERED I/O COMPLETION 
;TASK FORCE T-BIT TRAP (DEBUG CMD) 
;DELAYED I/O COMPLETION 
;GRP. GBL. RUNDWN 


BIT DEFINITIONS FOR THE GET/SET INFORMATION DIRECTIVE. 


SF.PRV='B'100000 
SF.IN='B' 40000 

; + 

; GROUP GLOBAL EVENT FLAG BLOCK 


.=0 

G.LNK:'L'.BLKW 1 
G.GRP:'L'.BLKB 1 
G.STAT:'L'.BLKB 1 
G.CNT:'L'.BLKW 1 
G.EFLG:'L'.BLKW 2 

G.LGTH='B'. 


GS.DEL='B'l 


;FUNCTION IS PRIVILEGED 
;FUNCTION IS AN INPUT FUNCTION 


OFFSETS 


;LINK WORD 
;GROUP NUMBER 
;STATUS BYTE 
;ACCESS COUNT 
;EVENT FLAGS 

;LENGTH OF GROUP GLOBAL EVENT FLAG 
;BLOCK 

;STATUS BIT — MARKED FOR DELETE 


+ 

EXECUTIVE POOL MONITOR CONTROL FLAGS 


; $POLST IS THE SYNCHRONIZATION WORD BETWEEN THE EXEC AND POOL MONITOR 


PC. HIH=' B ' 1 
PC.LOW='B'2 
PC.ALF='B'4 
PC.XIT='B'200 


PC.NRM='B'PC.HIH*400 
PC.ALM='B'PC.LOW* 400 


;HIGH POOL LIMIT CROSSED (1=YES) 

;LOW POOL LIMIT CROSSED (1=YES) 

;POOL ALLOCATION FAILURE (1=YES) 

;FORCE POOL MONITOR TASK TO EXIT (MUST 
;BE COUPLED WITH SETTING FE.MXT IN THE 
;FEATURE MASK) 

;POOL TASK INHIBIT BIT FOR HIGH POOL 
;POOL TASK INHIBIT BIT FOR LOW POOL 
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PKTDF$ (Cont.) 


; $POLFL IS THE POOL USAGE CONTROL WORD 


PF.INS='B'40 
PF.LOG='B'100 
PF.REQ='B'200 


;REJECT NONPRIVILEGED INS/RUN/REM 
;NONPRIVILEGED LOGINS ARE DISABLED 
;STALL REQUEST OF NONPRIV. TASKS 


PF.ALL='B'177777 


;TAKE ALL POSSIBLE ACTIONS TO SAVE POOL 


OFFSPRING CONTROL BLOCK DEFINITIONS 

SOME POSITIONAL DEPENDENCIES ARE DEPENDED ON BETWEEN THE OCB AND THE 
AST BLOCK IN THE ROUTINE $FINXT IN THE MODULE SYSXT. 


= 0 


O.LNK:'L' 

.BLKW 

1 

;OCB LINK WORD 

O.MCRL:'L 

1 .BLKW 

1 

;ADDRESS OF MCR COMMAND LINE 

O.PTCB: 'L 

' .BLKW 

1 

;PARENT TCB ADDRESS 

O.AST:'L' 

.BLKW 

1 

;EXIT AST ADDRESS 

O.EFN:'L' 

.BLKW 

1 

;EXIT EVENT FLAG 

O.ESB:'L' 

.BLKW 

1 

;EXIT STATUS BLOCK VIRTUAL ADDRESS 

O.STAT:'L 

' .BLKW 

8. 

;EXIT STATUS BUFFER 

O.LGTH='B 

i 


;LENGTH OF OCB 


+ 

I/O PACKET OFFSET DEFINITIONS 


.ASECT 

= 0 


I.LNK: 

'L' 

.BLKW 

1 

;I/0 QUEUE THREAD WORD 

I.PRIs 

1 L 1 

. BLKB 

1 

;REQUEST PRIORITY 

I.EFN: 

1 L 1 

.BLKB 

1 

;EVENT FLAG NUMBER 

I.TCB: 

'L' 

.BLKW 

1 

;TCB ADDRESS OF REQUESTOR 

I.LN2: 

1 L 1 

.BLKW 

1 

;POINTER TO SECOND LUN WORD 

I.UCB: 

1 L * 

.BLKW 

1 

;POINTER TO UNIT CONTROL BLOCK 

I.FCN: 

1 L 1 

.BLKW 

1 

;I/0 FUNCTION CODE 

I.IOSB 

: 1 L 1 

.BLKW 1 

;VIRTUAL ADDRESS OF I/O STATUS BLOCK 



.BLKW 

1 

;I/0 STATUS BLOCK RELOCATON BIAS 



.BLKW 

1 

;I/0 STATUS BLOCK ADDRESS 

I.AST: 

1 L 1 

.BLKW 

1 

;AST SERVICE ROUTINE ADDRESS 

I.PRM: 

'L' 

.BLKW 

1 

;RESERVED FOR MAPPING PARAMETER #1 



.BLKW 

6 

;PARAMETERS 1 TO 6 



.BLKW 

1 

;USER MODE DIAGNOSTIC PARAMETER WORD 


FOLLOWING ARE DEFINITIONS FOR FLAG BITS IN I.PRM+11 
(DSA DRIVERS INTERNAL USE ONLY) 


IP.FAK ='B' 20 
IP.ABO ='B' 40 
IP.PND ='B' 100 
IP.UMR ='B'200 


;IOP IS PSEUDO IOP 

;(MUDRV)ABORT COMMAND MUST BE ISSUED FOR IOP 
; (MUDRV)ABORT COMMAND WAS ISSUED FOR IOP 
;A UMR WAIT BLOCK IS IN USE FOR THIS I/O 
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PKTDF$ (Cont.) 


I.ATTL='B'. 


I.AADA:'L' .BLKW 2 

I.LGTH='B'. 

I.ATRL= 1 B'6*8. 


;MINIMUM LENGTH OF I/O PACKET (USED BY 
;FILE SYSTEM TO CALCULATE MAXIMUM 
;NUMBER OF ATTRIBUTES) 

;STORAGE FOR ATT DESCR PTRS WITH I/O 
;LENGTH OF I/O REQUEST CONTROL BLOCK 
;LENGTH OF FILE SYSTEM ATTRIBUTE BLOCK 


DEFINE OFFSETS IN I/O PACKET EXTENSION (IOPX) 

.ASECT 

0 


I.XLNK: 

'L' 

.BLKW 

1 

;LINK WORD 

I.XIOP: 

'L' 

.BLKW 

1 

;I/O PACKET ADDRESS 

I.XTCB: 

1 L 1 

.BLKW 

1 

;TCB ADDRESS OF REQUESTING TASK 

I.XMOD: 

' L 1 

.BLKW 

2 

;MODIFIER WORDS (NOTE: 2ND WORD MUST BE 
SPECIFIED AND MUST BE ZERO.) 

I.XRBF: 

'L' 

.BLKW 

2 

;READ DATA BUFFER ADDRESS APR BIAS 
;READ DATA BUFFER VIRTUAL ADDRESS 

I.XRBL: 

'L' 

.BLKW 

1 

;READ DATA BUFFER LENGTH 

I.XTMO: 

'L' 

.BLKW 

1 

;READ TIME-OUT INTERVAL 

I.XPBF: 

'L' 

.BLKW 

2 

;PROMPT BUFFER ADDRESS APR BIAS 
;PROMPT BUFFER VIRTUAL ADDRESS 

I.XPBL: 

'L' 

.BLKW 

1 

;PROMPT BUFFER LENGTH 

I.XPBV: 

'L' 

.BLKW 

1 

;PROMPT BUFFER VERTICAL FORMS CONTROL 

I.XTTB: 

'L* 

.BLKW 

2 

;TERMINATOR TABLE ADDRESS APR BIAS 
;TERMINATOR TABLE VIRTUAL ADDRESS 

I.XTTL: 

'L' 

.BLKW 

1 

;TERMINATOR TABLE LENGTH 

I.XDBF: 

'L' 

.BLKW 

2 

;DEFAULT INPUT BUFFER ADDRESS APR BIAS 
;DEFAULT INPUT BUFFER VIRTUAL ADDRESS 

I.XDBL: 

'L' 

.BLKW 

1 

;DEFAULT INPUT BUFFER LENGTH 


+ 

CLI PARSER BLOCK (CPB) DEFINITIONS 


.=0 


C.PTCB: 

1 L * 

.BLKW 

1 

;ADDRESS OF CLI'S TCB 

C.PNAM: 

'L' 

.BLKW 

2 

;CLI NAME 

C.PSTS: 

'L' 

.BLKW 

1 

;STATUS MASK 

C.PDPL: 

'L' 

. BLKB 

1 

;LENGTH OF DEFAULT PROMPT 

C.PCPL: 

1 L * 

• BLKB 

1 

;LENGTH O CNTRL/C PROMPT 

C.PRMT: 

'L' 



;START OF PROMPT STRINGS. DEFAULT 





;IS CONCATENATED WITH CONTROL C PROMPT 


STATUS BIT DEFINITIONS 


CP.NUL='B'1 
CP.MSG='B'2 
CP.LGO='B'4 
CP.DSB='B'10 
CP.PRV='B'20 
CP.SGL='B'40 
CP.NIO='B'100 


;PASS EMPTY COMMANDS TO CLI 

;CLI DESIRES SYSTEM MESSAGES 

;CLI WANTS COMMANDS FROM LOGGED OFF TTYS 

;CLI IS DISABLED 

;USER MUST BE PRIV TO SET TTY TO THIS CLI 
;DON'T HANDLE CONTINUATIONS (M-PLUS ONLY) 
;MCR..., HEL, BYE DO NO I/O TO TTY 
;HEL, BYE DO NOT SET CLI ETC. 
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CP.RST='B' 

200 


;ABILITY TO SET TO THIS CLI IS RESTRICTED 
;TO THE CLI ITSELF 

CP.EXT='B' 

400 


;PASS TASK EXIT PROMPT REQUESTS TO CLI 

CP.POL='B 1 

1000 


;CLI TCB IS IN SECONDARY POOL 

CP.CTC='B' 

2000 


;~C NOTIFICATION PACKETS ARE WANTED 

; + 

; SECONDARY POOL 

COMMAND BUFFER 

BLOCKS 

.=0 

C.CLK:'L' 

.BLKW 

1 

;LINK WORD 

C.CTCB:'L' 

.BLKW 

1 

;TCB ADDRESS OF TASK TO RECEIVE COMMAND 

C.CUCB:'L' 

.BLKW 

1 

;UCB ADDRESS OF RESPONSIBLE TERMINAL 

C.CCT:'L' 

.BLKW 

1 

;CHARACTER COUNT, EXCLUDING TRAILING CR 

C.CSTS:'L' 

.BLKW 

1 

;STATUS MASK 

C.CMCD:’L' 



;SYSTEM MESSAGE CODE 

C.CSO:'L' 

.BLKW 

1 

;STARTING OFFSET OF VALID COMMAND TEXT 

C.CTR:'L' 

.BLKB 

1 

;TERMINATOR CHARACTER 

C.CBLK:'L' 

.BLKB 

1 

;SIZE OF PACKET IN SEC POOL (32 WD.) BLOCKS 

C.CTXT:'L' 



;COMMAND TEXT, FOLLOWED BY CR 


+ 

STATUS BITS FOR COMMAND BLOCKS 


CC.MCR='B'1 
CC.PRM='B'2 
CC . E XT = ' B 1 4 
CC.KIL='B'10 
CC.CLI='B'2 0 
CC.MSG='B'40 
CC.TTD='B'100 
CC.CTC='B'200 


FORCE COMMAND TO MCR 
ISSUE DEFAULT PROMPT 
TASK EXIT PROMPT REQUEST 

DELETE ALL CONTINUATION PIECES FROM THIS TTY 
COMMAND TO BE RETREIVED BY GCCI$ ONLY 
PACKET CONTAINS SYSTEM MESSAGE TO CLI 
COMMAND CAME FROM TTDRV 
~C NOTIFICATION PACKET 


IDENTIFIER CODES FOR SYSTEM TO CLI MESSAGES 


CODES 0-127. ARE RESERVED FOR USE BY DIGITAL 
CODES 128.-255. ARE RESERVED FOR USE BY CUSTOMERS 


CM.INE='B'1 
CM.IND='B'2 
CM.CEN='B'3 
CM.CDS='B 1 4 
CM.ELM='B'5 
CM.EXT='B'6 
CM.LKT='B'7 
CM.RMT='B'8. 
CM.MSG='B'9. 


;CLI INITIALIZED ENABLED 
;CLI INITIALIZED DISABLED 
;CLI ENABLED 
;CLI DISABLED 
;CLI BEING ELIMINATED 
;CLI MUST EXIT IMMEDIATELY 
;NEW TERMINAL LINKED TO CLI 
;TERMINAL REMOVED FROM CLI 
;GENERAL MESSAGE TO CLI 


r ■*" 

; ANCILLARY CONTROL BLOCK (ACB) DEFINITIONS 


.=0 

A.REL:'L' .BLKW 1 
A.DIS:'L' .BLKW 1 
A.MAS:'L' .BLKW 2 
A.NUM:'L' .BLKB 1 
A.FLEN:'L'.BLKB 1 


;ACD RELOCATION BIAS 
;ACD DISPATCH TABLE POINTER 
;ACD FUNCTION MASK WORDS 
;ACD IDENTIFICATION NUMBER 
;LENGTH IN BYTES OF FULL ACB 
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A.LIN:'L' 

• BLKW 

1 

;ACD LINK WORD 

A.ACC:'L' 

• BLKB 

1 

;ACD ACCESS COUNT 

A.STA:'L' 

. BLKB 

1 

;ACD STATUS BYTE 

A.PLEN='B' 

i 


;LENGTH IN BYTES ' 


/ 

.=A.LIN 

A.IMAP:'L' .BLEW 1 
A. IBUF:'L' .BLEW 1 
A.ILEN:'L' .BLEW 1 
A.SMAP:'L' .BLEW 1 
A.SBUF:'L' .BLEW 1 
A.SLEN:'L' .BLEW 1 
A.IOS:'L' .BLEW 2 
A.RES='B 1 . 


;FULL ACB OVERLAPS PROTOTYPE ACB 
;ACD INTERRUPT BUFFER RELOCATION BIAS 
;ACD INTERRUPT BUFFER ADDRESS 
;ACD INTERRUPT BUFFER LENGTH 
;ACD SYSTEM STATE BUFFER RELOCATION BIAS 

;ACD SYSTEM STATE BUFFER ADDRESS 

;ACD SYSTEM STATE BUFFER LENGTH 

;ACD I/O STATUS 

;START OF ACB RESERVED FOR USE BY THE ACD 


DEFINE THE FLAG VALUES IN THE OFFSET U.AFLG 


UA.ACC='B'l 
UA.PRO='B'2 
UA.ECH=’B'4 
UA.TYP='B'10 
UA.SPE='B'20 
UA.PUT='B'40 
UA.CAL='B'100 
UA.COM='B'200 


;ACCEPT THIS CHARACTER 
;PROCESS THIS CHARACTER 
;ECHO THIS CHARACTER 

;FORCE THIS CHARACTER INTO TYPEAHEAD 
;THIS CHARACTER HAS A SPECIAL ECHO 
;PUT THIS CHARACTER IN THE INPUT BUFFER 
;CALL THE ACD BACK AFTER THE TRANSFER 
;COMPLETE THE INPUT REQUEST 


UA.ALL='B'400 
UA.TRN='B'1000 
UA.TRA='B'2000 


;ALLOW PROCESSING OF THIS I/O REQUEST 
;TRANSLATE CHARACTERS FROM OUTPUT QIO 
;TRANSFER CHARACTERS WHEN I/O COMPLETES 


DEFINE THE ACD ENTRY POINTS (OFFSETS INTO THE DISPATCH TABLE) 


.=0 


A.ACCE 

'L* 

• BLKW 

1 

;I/O REQUEST ACCEPTANCE ENTRY POINT 

A.DEQU 

'L' 

• BLKW 

1 

;I/O REQUEST DEQUEUE ENTRY POINT 

A.POWE 

'L' 

• BLKW 

1 

;POWER FAILURE ENTRY POINT 

A.INPU 

’L' 

• BLKW 

1 

;INPUT COMPLETION ENTRY POINT 

A.OUTP 

1 L 1 

• BLKW 

1 

;OUTPUT COMPLETION ENTRY POINT 

A.CONN 

'L' 

• BLKW 

1 

;CONNECTION ENTRY POINT 

A.DISC 

1 L ’ 

• BLKW 

1 

DISCONNECTION ENTRY POINT 

A.RECE 

'L' 

• BLKW 

1 

;INPUT CHARACTER RECEPTION ENTRY POINT 

A.PROC 

1 L 1 

• BLKW 

1 

;INPUT CHARACTER PROCESSING ENTRY POINT 

A.TRAN 

'L' 

• BLKW 

1 

;OUTPUT QIO CHARACTER TRANSLATION ENTRY POINT 

A.CALL 

'L' 

• BLKW 

1 

;CALL ACD BACK AFTER TRANSFER ENTRY POINT 


; DEFINE THE STATUS BITS IN 

AS.DLT='B 1 1 
AS.DIS='B 1 2 

•PSECT 


A.STA OF THE PROTOTYPE ACB 

;ACD IS MARKED FOR DELETE 
;ACD IS DISABLED 


•MACRO PKTDF$ X,Y,Z 
. ENDM 
. ENDM 
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•MACRO SCBDF$,L,B 


STATUS CONTROL BLOCK 

THE STATUS CONTROL BLOCK (SCB) DEFINES THE STATUS OF A DEVICE CONTROLLER. 
THERE IS ONE SCB FOR EACH CONTROLLER IN A SYSTEM. THE SCB IS POINTED TO 
BY UNIT CONTROL BLOCKS. TO EXPAND ON THE TELETYPE EXAMPLE ABOVE, EACH TELE¬ 
TYPE INTERFACED VIA A DL11-A WOULD HAVE A SCB SINCE EACH DL11-A IS AN IN¬ 
DEPENDENT INTERFACE UNIT. THE TELETYPES INTERFACED VIA THE DH11 WOULD ALSO 
EACH HAVE AN SCB SINCE THE DHll IS A SINGLE CONTROLLER BUT MULTIPLEXES MANY 
UNITS IN PARALLEL. 


.IF NB SYSDEF 


.ASECT 

.=0 

S.LHD:'L' .BLKW 2 
S.URM:'L' 


CONTROLLER I/O QUEUE LISTHEAD 
;REFERENCE LABEL 


.IF DF M$$PRO 

.BLKW 1 ;UNIBUS RUN MASK FOR THE FORK BLOCK 

. ENDC 


S.FRK:'L' .BLKW 1 
.BLKW 1 
•BLKW 1 
.BLKW 1 


FORK BLOCK LINK WORD 

FORK-PC 

FORK-R5 

FORK-R4 


•IF DF L$$DRV 

S.KS5: 1 L' .BLKW 1 ;FORK KISAR5 

.ENDC 


S.PKT:’L' 

.BLKW 

1 

;ADDRESS OF CURRENT I/O PACKET 

S.CTM:’L’ 

. BLKB 

1 

;CURRENT TIMEOUT COUNT 

S.ITM:'L' 

. BLKB 

1 

;INITIAL TIMEOUT COUNT 

S.STS:'L' 

.BLKB 

1 

;STATUS (0=FREE, NE 0=BUSY) 

S.ST3:'L' 

.BLKB 

1 

;STATUS EXTENSION BYTE 

S.ST2:'L' 

.BLKW 

1 

;STATUS EXTENSION 

S.KRB:’L' 

.BLKW 

1 

;ADDRESS OF KRB 

S.RCNT:'L 

1 .BLKB 

1 

;NUMBER OF REGISTERS TO COPY 

S.ROFF:'L 

' .BLKB 

1 

;OFFSET TO FIRST DEV REG TO COPY 

S.EMB:’L' 

.BLKW 

1 

;ERROR MESSAGE BLOCK POINTER 

S.KTB:’L' 

.BLKW 

1 

;START OF MULTI-ACCESS KRBS 


.PSECT 
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+ 

OFFSETS FOR MSCP/TMSCP DRIVER DATA BASES (MUDRV, DUDRV) 


S.PORT='B'S.EMB+2 
S.PBIA =, B'S.EMB+4 
S.QST=’B'S.EMB+6 
S.BSYU='B'S.EMB+10 

. IFF 


;FIRST 3 CHAR. OF PORT NAME IN RAD50 
;BIAS OF PORT 

;ADDRESS OF QST (MU,DU CONTR. TABLE) 

;UNIT ASSOCIATED WITH OLDEST CMD TO CONTR. 


+ 

STATUS CONTROL BLOCK STATUS EXTENSION BIT DEFINITIONS 


S2.ElP='B'1 
S2.ENB='B ' 2 
S2.LOG='B'4 
S2.MAD='B'10 
S2.LDS='B’40 
S 2.OPT='B'100 
S2.CON='B 1 200 
S2.0P1='B'400 
S2.OP2='B'1000 


S2.ACT='B'2000 
S2.XHR='B'4000 
S2.KRQ='B'10000 


ERROR IN PROGRESS (1=YES) 

ERROR LOGGING ENABLED (0=YES) 

ERROR LOGGING SUPPORTED (1=YES) 
MULTIACCESS DEVICE (1=YES) 

LOAD SHARING ENABLED (1=YES) 

SUPPORTS SEEK OPTIMIZATION (1=YES) 

SCB AND KRB ARE CONTIGUOUS (1=YES) 

THESE TWO BITS DEFINE THE OPTIMIZATION 
METHOD. 

OP2,OP1=0,0 INDICATES NEAREST CYLINDER 
OP2,OP1=0,1 INDICATES ELEVATOR 
OP2,OPl=l,0 INDICATES C-SCAN 
OP2,OPl=l,1 RESERVED 

DRIVER HAS OPERATION OUTSTANDING (1=YES) 
EXTERNAL HEADER AND NEW I.LN2 SUPPORT 
SCB IS QUEUED IN CONTROLLER REQUEST QUEUE 


+ 

STATUS CONTROL BLOCK STATUS EXTENSION (S.ST3) DEFINITIONS 


S3.DRL='B'1 

S3.NRL='B'2 

S3.SIP='B'4 

S3.ATN='B'10 

S3.SLV='B'20 

S3.SPA='B 1 40 

S3.SPB='B'100 

S 3.OPT='B'200 

S3.SPU='B'S3.SPA!S3.SPB 


;MULTI-ACCESS DRIVE IN RELEASED STATE (1=YES) 

;DRIVER SHOULDN’T RLS MULTI-ACCESS DRIVE (1=YES) 
;SEEK IN PROGRESS (1=YES) 

;DRIVER MUST CLEAR ATTENTION BIT (1=YES) 

;DEVICE USES SLAVE UNITS (1=YES) 

;PORT ’A' SPINNING UP 
;PORT 'B' SPINNING UP 
;SEEK OPTIMIZATION ENABLED (1=YES) 

;.OR. OF PORT SPINUP BITS 


+ 

KRB ADDRESS TABLE (S.KTB) PORT OFFLINE FROM THIS SCB FLAG. 


KP.OFL='B ' 1 


; KRB ADDRESS POINTS TO OFFLINE PORT (1=YES) 


+ 

MAPPING ASSIGNMENT BLOCK (FOR UNIBUS MAPPING REGISTER ASSIGNMENT) 
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.ASECT 


.=0 




M.LNK:' 

L' 

. BLKW 

1 

M.UMRA: 

1 L 1 

. BLKW 

1 

M.UMRN: 

1 L * 

.BLKW 

1 

M. UMVL: 

•L' 

.BLKW 

1 

M.UMVH: 

'L' 

. BLKB 

1 

M.BFVH: 

* L * 

. BLKB 

1 

M.BFVL: 

'L' 

.BLKW 

1 

M.LGTH= 

'B' 

. 



;LINK WORD 

;ADDRESS OF FIRST ASSIGNED UMR 
;NUMBER OF UMR'S ASSIGNED * 4 
;LOW 16 BITS MAPPED BY 1ST ASSIGNED UMR 
;HIGH 2 BITS MAPPED IN BITS 4 AND 5 
;HIGH 6 BITS OF PHYSICAL BUFFER ADDRESS 
;LOW 16 BITS OF PHYSICAL BUFFER ADDRESS 
;LENGTH OF MAPPING ASSIGNMENT BLOCK 


. ENDC 


.PSECT 

.MACRO SCBDF$,X,Y,Z 
. ENDM 
. ENDM 
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.MACRO SHDDF$,L,B 


FIRST, WE MUST DEFINE THE I/O PACKET DEFINITIONS, SINCE WE 
USE THEM IN OUR DEFINITIONS. 


PKTDF$ 


;DEFINE I/O PACKET DEFINITIONS 


SHADOW RECORDING LINKAGE BLOCK (UMB) 

THE UMB LINKS TOGETHER TWO UCB'S AS A SHADOW SET. ONE IS THE 
PRIMARY UCB, THE OTHER THE SECONDARY UCB. THE EXISTANCE OF A 
UMB SIGNALS THAT SHADOW RECORDING IS ENABLED ON A PARTICULAR 
UCB. 


.ASECT 


.=0 

M.LNK: 

'L' 

• BLKW 

M.LHD: 

'L' 

. BLKW 

M.UCBS 

: ' L 1 

1 .BLKW 

M.STS: 

'L' 

.BLKW 

M.LBN: 

'L* 

.BLKB 

M.LGH= 


. BLKB 
.BLKW 


1 

1 

2 

1 

1 

1 

1 


;LINKAGE OF ALL UMB'S IN THE SYSTEM 
;LISTHEAD OF ALL ML NODES FOR THIS SET 
;PRIMARY AND SECONDARY UCB ADDRESSES 
;STATUS WORD 

;HIGH ORDER BYTE OF FENCE 
;UNUSED BYTE (MAYBE STATUS?) 

;LOW ORDER WORD OF FENCE 


+ 

UMB STATUS BIT DEFINITIONS 


.PSECT 

MS .MDA'B'=1 ;UMB MARKED FOR DEALLOCATION (1=YES) 

MS.CHP'B'=2 ;CATCHUP IN PROGRESS (1=YES) 

; + 

; DEFINE THE OFFSETS FOR THE ML NODE, LINKED OFF OF THE UMB 
; THROUGH CELL M.LHD. THIS NODE CONTAINS THE SECONDARY I/O 
; PACKET, AND DOUBLES AS THE ERROR PACKET TO THE ERROR MESSAGE 
; TASK. 


.ASECT 


.=0 


ML.LNK: 

'L 1 

.BLKW 

ML.LEN: 

'L' 

.BLKB 

ML.TYP: 

'L' 

.BLKB 

ML.DNC: 

1 L 1 

.BLKB 

.BLKB 

ML.PRI: 

•L* 

.BLKW 

ML.PKT: 
ML.LGH= 

* L ' 

.BLKB 


1 

1 

1 

1 

1 

1 

I.LGTH 


;LINKAGE OF ALL ML NODES ON UMB 
;LENGTH OF ML NODE FOR DEALLOCATION 
;TYPE OF ML NODE FOR ERROR TASK 
;DONE COUNT OF PACKETS 
; UNUSED 

;PRIMARY I/O PACKET ADDRESS 
;SECONDARY I/O PACKET 
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+ 

ML NODE TYPE CODES 


.PSECT 

MT.PKT'B'=1 ;ML NODE IS I/O PACKET 

; + 

; I/O PACKET OFFSET DEFNS FOR USE BY SHADOW RECORDING 


I.R0'B'=I.PRM ;STATUS STORAGE FOR RO 

I.R1'B'=I.PRM+2 ;STATUS STORAGE FOR Rl 

; + 

; DEFINE THE ERROR MESSAGE POINTERS THAT RESIDE IN THE 


TYPE 

STATUS 

STATUS 

I/O PACKET. 


.PSECT 

;FILE ID WHICH CONTAINS ERROR 
;FILE SEQUENCE NUMBER OF FILE IN ERROR 
;HIGH ORDER LBN OF BLOCK(S) IN ERROR 
;NUMBER OF BLOCKS IN BAD XFER 
;TCB OF TASK WITH BAD REQUEST 
;R0 OF SECONDARY I/O PACKET 
;R1 OF SECONDARY I/O PACKET 
;R0 OF PRIMARY I/O PACKET 
;Rl OF PRIMARY I/O PACKET 


.MACRO SHDDF $,X,Y,Z 
. ENDM 
. ENDM 


ML.FID'B 1 =ML.PKT+I.IOSB 
ML.FSEQ'B'=ML.PKT+I.IOSB+2 
ML.LBN'B'=ML.PKT+I.PRM+10 
ML.CNT'B'=ML.PKT+I.PRM+4 
ML.TCB'B'=ML.PKT+I.TCB 
ML.SRO'B'=ML.PKT+I.RO 
ML.SRI'B'=ML.PKT+I.Rl 
ML.PRO'B'=ML.PKT+I.PRM+14 
ML.PR1’B'=ML.PKT+I.PRM+16 
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.MACRO TCBDF$, L,B 
f 

TASK CONTROL BLOCK OFFSET AND STATUS DEFINITIONS 
TASK CONTROL BLOCK 

.ASECT 


.=0 

T.LNK:’L' 

.BLKW 1 

T.PRI:'L' 

•BLKB 1 

T.IOC:’L’ 

•BLKB 1 

T.PCBV:'L 

' .BLKW 1 

T.NAM:'L' 

.BLKW 2 

T.RCVL:'L 

’ .BLKW 2 

T.ASTL:'L 

' .BLKW 2 

T.EFLG:'L 

' .BLKW 2 

T.UCB:'L' 

•BLKW 1 

T.TCBL: 'L 

' .BLKW 1 

T.STAT:'L 

’ .BLKW 1 

T.ST2:'L' 

.BLKW 1 

T.ST3:'L' 

.BLKW 1 

T.DPRI: ’L 

' .BLKB 1 

T.LBN:’L’ 

.BLKB 3 

T.LDV:'L' 

.BLKW 1 

T.PCB:'L' 

.BLKW 1 

T.MXSZ:'L 

' .BLKW 1 

T.ACTL:'L 

' .BLKW 1 

T.ATT:'L' 

.BLKW 2 

T.ST4: 'L' 

•BLKW 1 

T.HDLN: 'L 

' .BLKB 1 

.BLKB 1 

T.GGF:'L' 

.BLKB 1 

T.TIO: 'L' 

.BLKB 1 

T.EFLM:'L 

’ .BLKW 2 

T.TKSZ:'L 

' .BLKW 1 

$$$=. 

T.OFF:'L' 

.BLKW 1 

.BLKB 1 

T.SRCT: 'L 

' .BLKB 1 

T.RRFL:'L 

1 .BLKW 2 


.=$$$ 


.IF NDF P$$LAS 


. ENDC 


.IF NB SYSDEF 


$$$=. 


UTILITY LINK WORD 
TASK PRIORITY 
I/O PENDING COUNT 
POINTER TO COMMON PCB VECTOR 
TASK NAME IN RAD50 
RECEIVE QUEUE LISTHEAD 
AST QUEUE LISTHEAD 
TASK LOCAL EVENT FLAGS 1-32 
UCB ADDRESS FOR PSEUDO DEVICE 1 TI 
TASK LIST THREAD WORD 
FIRST STATUS WORD (BLOCKING BITS) 

SECOND STATUS WORD (STATE BITS) 

THIRD STATUS WORD (ATTRIBUTE BITS) 

TASK'S DEFAULT PRIORITY 

LBN OF TASK LOAD IMAGE 

UCB ADDRESS OF LOAD DEVICE 

PCB ADDRESS OF TASK PARTITION 

MAXIMUM SIZE OF TASK IMAGE (MAPPED ONLY) 

ADDRESS OF NEXT TASK IN ACTIVE LIST 

ATTACHMENT DESCRIPTOR LISTHEAD 

FOURTH TASK STATUS WORD 

LENGTH OF HEADER (0 IF HDR IN POOL) 

UNUSED 

GROUP GLOBAL USE COUNT FOR TASK 
BUFFERED I/O IN PROGRESS COUNT 
TASK WAITFOR MASK/ADDRESS 
TASK LOAD SIZE IN 32 WD BLOCKS 

;MARK START OF PLAS AREA 

;OFFSET TO TASK IMAGE IN PARTITION 

?RESERVED 

;SREF WITH EFN COUNT IN ALL RECEIVE QUEUES 

;RECEIVE BY REFERENCE LISTHEAD 


;MOVE LC BACK TO START OF PLAS AREA 
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T.CTX:'L' .BLKW 1 

.IF NDF N$$DIR 


;POINTER TO CONTEXT BLOCK (DDS) 


.=$$$ 


.ENDC ; NDF N$$DIR 


$$$=. 


T.OCBH:'L' .BLKW 2 
T.RDCT:'L' .BLKW 1 


;MARK START OF PARENT/OFFSPRING AREA 

;OFFSPRING CONTROL BLOCK LISTHEAD 
OUTSTANDING OFFSPRING AND VT: COUNT 


.IF NDF P$$OFF 


.=$$$ 

.ENDC 


T.SAST:'L' .BLKW 1 


$$$ = . 


T.RRM:'L'.BLKW 1 
T.IRM:'L'.BLKW 1 


T.CPU:'L'.BLKB 1 
.BLKB 1 

.IF NDF M$$PRO 


;SPECIFY AST LIST HEAD 


;REQUIRED RUN MASK 

;INITIAL RUN MASK SET UP BY INSTALL 
; **** THIS word IS NO LONGER NECESSARY 
;**** HOWEVER, INSTALL (INSLB), MCR (SPAWN), 
;**** AND VMR MUST BE MODIFIED 

;PROCESSOR NUMBER ON WHICH TASK LAST EXECUTED 
;(UNUSED) 


.=$$$ 


.ENDC 

$$$ = . 


T.ACN:'L'.BLKW 1 


;POINTER TO ACCOUNTING BLOCK 


.IF NDF A$$CNT 


.=$$$ 

.ENDC 


$$$ = . 


T.ISIZ:'L 1 .BLKW 1 

.IF NDF U$$DAS 


;SIZE OF ROOT I SPACE 
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.=$$$ 


.ENDC ; NDF U$$DAS 


T.LGTH='B ' . 
T.EXT='B’0 


. IFF 


;LENGTH OF TASK CONTROL BLOCK 
;LENGTH OF TCB EXTENSION 


TASK STATUS DEFINITIONS 

FIRST STATUS WORD (BLOCKING BITS) 


TS.EXE='B'100000 
TS.RDN='B'40000 
TS.MSG='B'20000 
TS.CIP='B'10000 
TS.RUN='B'4000 
TS.STP= 1 B'1000 
TS.CKR= 1 B'100 
TS.BLC='B'37 

; + 

; TASK BLOCKING STATUS MASK 


;TASK NOT IN EXECUTION (1=YES) 

;I/O RUN DOWN IN PROGRESS (1=YES) 

;ABORT MESSAGE BEING OUTPUT (1=YES) 

;TASK BLOCKED FOR CHECKPOINT IN PROGRESS (1=YES) 
;TASK IS RUNNING ON ANOTHER PROCESSOR (1=YES) 

;TASK BLOCKED BY CL I COMMAND 

;TASK HAS CKP REQUEST (MP SYSTEM ONLY) (1=YES) 

;INCREMENT BLOCKING COUNT MASK 


TS.BLK='B'177777 


+ 

SECOND STATUS WORD (STATE BITS) 


T2.AST='B'100000 
T2.DST='B'40000 
T2.CHK='B'20000 
T2.REX='B'10000 
T2.SEF='B'4000 
T2.SIO='B'1000 
T2.AFF='B'400 
T 2.HLT='B'200 
T2.ABO='B'100 
T2.STP='B'40 
T2.STP='B'20 
T 2.SPN='B'10 
T2.SPN=’B'4 
T2.WFR='B'2 
T2.WFR=’B'l 


;AST IN PROGRESS (1=YES) 

;AST RECOGNITION DISABLED (1=YES) 

;TASK NOT CHECKPOINTABLE (1=YES) 

;REQUESTED EXIT AST SPECIFIED 
;TASK STOPPED FOR EVENT FLAG (S) (1=YES) 

;TASK STOPPED FOR BUFFERED I/O 
;TASK IS INSTALLED WITH AFFINITY 
;TASK IS BEING HALTED (1=YES) 

;TASK MARKED FOR ABORT (1=YES) 

;SAVED T2.SPN ON AST IN PROGRESS 
;TASK STOPPED (1=YES) 

;SAVED T2.SPN ON AST IN PROGRESS 
;TASK SUSPENDED (1=YES) 

;SAVED T2.WFR ON AST IN PROGRESS 
;TASK IN WAITFOR STATE (1=YES) 


+ 

THIRD STATUS WORD (ATTRIBUTE BITS) 


T3.ACP='B'100000 
T 3.PMD='B'40000 
T3.REM='B'20000 
T3.PRV='B'10000 


,-ANCILLARY CONTROL PROCESSOR (1 = YES) 
;DUMP TASK ON SYNCHRONOUS ABORT (0=YES) 
;REMOVE TASK ON EXIT (1=YES) 

;TASK IS PRIVILEGED (1=YES) 
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T3.MCR='B'4000 
T 3.SLV= 1 B 1 2000 
T3.CLI= 1 B'1000 
T3.RST='B ' 400 
T3.NSD='B'200 
T3.CAL='B'100 
T3.ROV='B'40 
T3.NET=’B'20 
T3.MPC='B'10 
T3.CMD='B'4 
T3.SWS='B'2 
T3.GFL='B'l 

; + 

,* STATUS BIT DEFINITIONS 


T4.FMP='B'200 
T4.CTC=’B'100 
T4.MUT='B'40 
T4.LDD='B'20 
T4.PRO='B'10 
T4.PRV='B'4 

T4.DSP='B'2 
T4.SNC='B'1 

; + 

; REQUIRED RUN MASK 


TR.UBT='B'100000 
TR.UBS='B'40000 
TR.UBR='B'20000 
TR.UBP='B'10000 
TR.UBN='B'4000 
TR.UBM='B'2000 
TR.UBL='B'1000 
TR.UBK='B'400 
TR.UBJ='B’200 
TR.UBH='B'100 
TR.UBF='B'40 
TR.UBE='B'20 
TR.CPD='B'10 
TR.CPC='B'4 
TR.CPB='B'2 
TR.CPA='B'1 

. ENDC 


.PSECT 

.MACRO TCBDF$ 
. ENDM 
. ENDM 



TASK REQUESTED AS EXTERNAL MCR FUNCTION (1=YES) 


TASK IS A SLAVE TASK (1=YES) 

TASK IS A COMMAND LINE INTERPRETER (1=YES) 
TASK IS RESTRICTED (1=YES) 

TASK DOES NOT ALLOW SEND DATA 

TASK HAS CHECKPOINT SPACE IN TASK IMAGE 

TASK HAS RESIDENT OVERLAYS 

NETWORK PROTOCOL LEVEL 

MAPPING CHANGE WITH OUTSTANDING I/O (1=YES) 
TASK IS EXECUTING A CLI COMMAND 
RESERVED FOR SOFTWARE SERVICES USE 
GROUP GLOBAL EVENT FLAG LOCK 


FOR FOURTH STATUS WORD (T.ST4) 


;TASK HAS FAST MAP HDR EXT. 

;TASK HAS BEEN PROCESSED BY GIN ~C ABORT 
;TASK IS A MULTI-USER TASK 
;TASK'S LOAD DEVICE HAS BEEN DISMOUNTED 
;TCB IS (OR SHOULD BE) A PROTOTYPE 
;TASK WAS PRIV, BUT HAS CLEARED T3.PRV 
;WITH GIN (MAY RESET WITH GIN IF T4.PRV SET 
;TASK WAS BUILT FOR USER I/D SPACE 
;TASK USES COMMONS FOR SYNCHRONIZATION 



) 


UNIBUS 

RUN 

T 

UNIBUS 

RUN 

S 

UNIBUS 

RUN 

R 

UNIBUS 

RUN 

P 

UNIBUS 

RUN 

N 

UNIBUS 

RUN 

M 

UNIBUS 

RUN 

L 

UNIBUS 

RUN 

K 

UNIBUS 

RUN 

J 

UNIBUS 

RUN 

H 

UNIBUS 

RUN 

F 

UNIBUS 

RUN 

E 

PROCESSOR C 

i 

PROCESSOR C 


PROCESSOR B 

PROCESSOR A 



,Y,Z 
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•MACRO UCBDF$,L,B,TTDEF 


UNIT CONTROL BLOCK 

THE UNIT CONTROL BLOCK (UCB) DEFINES THE STATUS OF AN INDIVIDUAL DEVICE 
UNIT AND IS THE CONTROL BLOCK THAT IS POINTED TO BY THE FIRST WORD OF 
AN ASSIGNED LUN. THERE IS ONE UCB FOR EACH DEVICE UNIT OF EACH DCB. THE 
UCB'S ASSOCIATED WITH A PARTICULAR DCB ARE CONTIGUOUS IN MEMORY AND ARE 
POINTED TO BY THE DCB. UCB'S ARE VARIABLE LENGTH BETWEEN DCB'S BUT ARE 
OF THE SAME LENGTH FOR A SPECIFIC DCB. TO FINISH THE TELETYPE EXAMPLE 
ABOVE, EACH UNIT ON BOTH INTERFACES WOULD HAVE A UCB. 


.ASECT 


.=177772 


.IF NB SYSDEF 


.IF DF A$$CNT 

.=.-2 

.ENDC ;DF A$$CNT 


•IF DF L$$GCL 

.=.-2 

.ENDC ;DF L$$GCL 

.=.-2 

.IF DF N$$DIR 

.=.-2 

.ENDC ;DF N$$DIR 

U.UAB:'L' 

.IF DF A$$CNT 

.BLKW 1 ;POINTER TO USER ACCOUNT BLOCK 

•ENDC ;DF A$$CNT 

U.LOG:'L’ 

.IF DF L$$GCL 

.BLKW 1 ;POINTER TO USER LOGICAL HASH TABLE 

.ENDC ;DF L$$GCL 


U.FPRO: 'L ' 

.BLKW 1 ;DEFAULT FILE PROTECTION WORD 
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U.CTX:'L' 


.IF DF N$$DIR 

.BLKW 1 ;POINTER TO TERMINAL CONTEXT BLOCK 

.ENDC ;DF N$$DIR 


. ENDC ; NB SYSDEF 


U.MUP:'L' 
U.LUIC:'L' 
U.OWN:'L' 
U.DCB:’L' 
U.RED:'L' 
U.CTL: 'L' 
U.STS:'L' 
U.UNIT:'L' 
U.ST2:'L' 
U.CW1:'L' 
U.CW2:'L' 
U.CW3:'L' 
U.CW4:'L' 
U.SCB: 'L' 
U.ATT:'L' 
U.BUF: 'L' 


.BLKW 1 
•BLKW 1 
.BLKW 1 
.BLKW 1 
.BLKW 1 
.BLKB 1 
.BLKB I 
.BLKB 1 
.BLKB 1 
.BLKW 1 
.BLKW I 
.BLKW 1 
.BLKW 1 
.BLKW 1 
.BLKW 1 
•BLKW 1 
.BLKW 1 


MULTI-USER PROTECTION WORD 

LOGIN UIC - MULTI USER SYSTEMS ONLY 

OWNING TERMINAL - MULTI USER SYSTEMS ONLY 

BACK POINTER TO DCB 

POINTER TO REDIRECT UNIT UCB 

CONTROL PROCESSING FLAGS 

UNIT STATUS 

PHYSICAL UNIT NUMBER 

UNIT STATUS EXTENSION 

FIRST DEVICE CHARACTERISTICS WORD 

SECOND DEVICE CHARACTERISTICS WORD 

THIRD DEVICE CHARACTERISTICS WORD 

FOURTH DEVICE CHARACTERISTICS WORD 

POINTER TO SCB 

TCB ADDRESS OF ATTACHED TASK 
RELOCATION BIAS OF CURRENT I/O REQUEST 
BUFFER ADDRESS OF CURRENT I/O REQUEST 


U.CNT:'L' .BLKW 1 
U.UCBX='B 1 U.CNT+2 
U.ACP='B'U.CNT+4 
U.VCB='B'U.CNT+6 
U.CBF='B'U.CNT+2 
U.UMB='B'U.CNT+IO 
U.PRM='B'U.CNT+12 
U.ICSR='B'U.CNT+16 
U.SLT='B'U.CNT+20 
U.SPRM='B'U.CNT+22 
U.UTIL='B'U.CNT+16 


BYTE COUNT OF CURRENT I/O REQUEST 

POINTER TO UCB EXTENSION IN SECONDARY POOL 

ADDRESS OF TCB OF MOUNTED ACP 

ADDRESS OF VOLUME CONTROL BLOCK 

CONTROL BUFFER RELOCATION AND ADDRESS 

ADDRESS OF UMB FOR SHADOW RECORDING 

DISK SIZE PARAMETER WORDS 

CSR ADDRESS (P/OS) 

SLOT ADRESS (P/OS) 

4 WD SAVED I/O PACKET AREA (R$$AMD) 

STATE WORD FOR UNIT 


DEFINITIONS FOR U.UTIL BITS 


UU.SER 

_ \ 

1 B 1 1 

;SERIAL MODE 

UU.RCT 

_i 

•B'2 

; (DUDRV)RCT IN PROGRESS 

UU.AVN 

_ ! 

1 B 1 4 

IS WAITING FOR OTHER UNITS TO SPIN DOWN 

UU.GUS 


' B 1 10 

;UNIT MUST HAVE A GUS COMMAND ISSUED 

UU.ONL 

_ l 

1 B * 2 0 

;UNIT MUST HAVE A ONL COMMAND ISSUED 

UU.SPC 

= 

*B 1 40 

;SPECIAL ONLINE TRANSITION 

UU.ATN 


' B 1 100 

;UNIT HAS SENT ATTENTION MESSAGE 

UU.RDY 

= 

'B ' 200 

;UNIT IS READY 

UU.ABO 

= 

' B'400 

; IF SET, XXCAN SET UU.SER FLAG FOR UNIT 

UU.SIO 

= 

'B ' 100 0 

;THIS UNIT CAN STALL I/O 

UU.IOS 

= 

1 B ' 2000 

;THIS UNIT HAS I/O STALLED 

UU.BLK 

= 

'B'4000 

;THIS UNIT DOESN'T ACCEPT DENSITY SETTINGS 
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U.BPKT='B'U.CNT+20 
U.MEDI='B'U.BPKT 
U.UC2X= 1 B'U.CNT+24 


;UNIT BAD BLOCK REPLACEMENT WAITING LIST 
;MEDIA IDENTIFIER FOR MU TAPE 

;POINTER TO SECOND EXTENSION IN SECONDARY POOL 


MAGTAPE DEVICE DEPENDENT UCB OFFSETS 


U.SNUM='B'U.CNT+10 
U.FCDE='B'U.CNT+12 
U.KRBl='B'U.CNT+14 


;SLAVE UNIT NUMBER 
jFUNCTION CODE 
;SUBCONTROLLER KRB1 POINTER 


; DEFINE SECONDARY POOL UCB EXTENSION OFFSETS (ERROR LOGGING DEVICES ONLY) 

!=o 



.BLKW 9. 

;FIXED ACCOUNTING TRANSACTION HEADER 

X.NAME: 

1 L 

' .BLKW 2 

;DRIVE NAME IN RAD50 

X.IOC:' 

L* 

•BLKW 2 

;I/O COUNT 

X.ERSL: 

'L 

' .BLKB 1 

;SOFT ERROR LIMIT 

X.ERHL: 

'L 

' .BLKB 1 

;HARD ERROR LIMIT 

X.ERSC: 

'L 

' .BLKB 1 

;SOFT ERROR COUNT 

X.ERHC: 

1 L 

' .BLKB 1 

;HARD ERROR COUNT 

X.WCNT: 

'L 

' .BLKW 2 

;WORDS TRANSFERED COUNT 


; DEFINE OFFSETS 

t 

FOR 

SEEK OPTIMIZATION DEVICES 

X.CYLC:' 

L' 

1 .BLKW 

2 

CYLINDERS CROSSED COUNT 

X.CCYL: 1 

'L 

' .BLKW 

1 

;CURRENT CYLINDER 

X.FCUR:' 

L 

' .BLKB 

1 

;CURRENT FAIRNESS COUNT 

X.FLIM:' 

'L 

1 


;FAIRNESS COUNT LIMIT 

X.DSKD:' 

L 

' .BLKB 

1 

;DISK DIRECTION (HIGH BIT l=OUT) 

X.DNAM:' 

'L 

' .BLKW 

1 

;DEVICE NAME FOR ACCOUNTING 

X.UNIT:' 

'L 

' .BLKB 

1 

;UNIT NUMBER FOR ACCOUNTING 

X.CSTS: 1 

'L 

' .BLKB 

1 

;CACHE STATUS BITS 

X.CPCB:' 

L 

1 .BLKW 

1 

;CACHE PARTITION PCB ADDRESS 

X.CSBA: 1 

'L 

1 .BLKW 

1 

;CACHE STATISTICS BUFFER ADDRESS (BIAS) 

X.CCED: 1 

'L 

1 .BLKW 

2 

;CACHE EXTENT DESCRIPTOR LISTHEAD 

X.XDAT:' 

'L 

' .BLKB 

1 

;CACHE VIRTUAL EXTENT SIZE 

X.XRDA: 1 

'L 

' .BLKB 

1 

;CACHE READAHEAD EXTENT SIZE 

X.XDIR:' 

'L 

1 .BLKB 

1 

;CACHE DIRECTORY EXTENT SIZE 

X.XLOG:' 

L 

' .BLKB 

1 

?CACHE LOGICAL EXTENT SIZE 

X.XOVR:' 

'L 

' .BLKB 

1 

;CACHE OVERLAY EXTENT SIZE 



.BLKB 

1 

;RESERVED 

X .LGTH=' 

'B 1 

1 , 


;LENGTH OF THE UCB EXTENSION 

X. DFFL= 1 

B 

■10. 


;DEFAULT FAIRNESS COUNT LIMIT 

X. DFSL=' 

'B 

'8. 


;DEFAULT SOFT ERROR LIMIT 

X. DFHL=' 

B 

•5. 


;DEFAULT HARD ERROR LIMIT 


CACHE STATUS BITS IN X.CSTS 
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XC.ENA='B'200 
XC.ACT='B’100 
XC.DIR=’B'020 
XC.OVR ='B'010 
XC.DAT='B'004 
XC.LOG='B'002 
XC.RDA='B'001 


;AUTOCACHE ENABLED (1=YES) 

;CACHE ACTIVE FOR DEVICE (1=YES) 
;CACHE DIRECTORY REQUESTS (1=YES) 
;CACHE OVERLAY REQUESTS (1=YES) 

;CACHE VIRTUAL REQUESTS (1=YES) 
;CACHE LOGICAL REQUESTS (1=YES) 

;CACHE VIRTUAL READ AHEAD (1=YES) 


; DEFINE CACHE MAXIMUM AND DEFAULT EXTENT SIZES 


XX.MAX=’B'15. 
XX.DAT='B'5. 
XX.RDA='B'5. 
XX.DIR='B'l. 
XX.LOG='B 1 1. 
XX.OVR='B'4. 


MAXIMUM 

DEFAULT 

DEFAULT 

DEFAULT 

DEFAULT 

DEFAULT 


EXTENT SIZE 
VIRTUAL EXTENT SIZE 
READAHEAD EXTENT SIZE 
DIRECTORY EXTENT SIZE 
LOGICAL EXTENT SIZE 
OVERLAY EXTENT SIZE 


; DEFINE OFFSETS FOR DISK MSCP CONTROLLERS (SECOND UCB EXTENSION) 


; CHARACTERISTICS OBTAINED FROM "GET UNIT STATUS" END PACKETS 


.=0 


X.MLUN: 

1 L ' 

.BLKW 

1 

;MULTI-UNIT CODE 

X.UNFL: 

'L' 

.BLKW 

1 

;UNIT FLAGS 



.BLKW 

2 

;RESERVED 

X.UNTI: 

’L' 

.BLKW 

4 

;UNIT IDENTIFIER 

X.MEDI: 

'L' 

.BLKW 

2 

;MEDIA IDENTIFIER 

X.SHUN: 

1 L ' 

.BLKW 

1 

;SHADOW UNIT 

X.SHST: 

'L' 

.BLKW 

1 

;SHADOW UNIT STATUS 

X.TRCK: 

'L' 

.BLKW 

1 

;UNIT TRACK SIZE 

X.GRP:' 

L' . 

BLKW 

1 

;UNIT GROUP SIZE 

X.CYL: ' 

L' . 

BLKW 

1 

;UNIT CYLINDER SIZE 

X.USVR: 

'L' 

. BLKB 

1 

;UNIT SOFTWARE VERSION 

X.UHVR: 

1 L ' 

. BLKB 

1 

;UNIT HARDWARE VERSION 

X.RCTS: 

'L' 

.BLKW 

1 

;UNIT RCT TABLE SIZE 

X.RBNS: 

'L' 

.BLKB 

1 

;UNIT RBN ' S / TRACK 

X.RCTC: 

1 L 1 

.BLKB 

1 

;UNIT RCT COPIES 


t 

; CHARACTERISTICS OBTAINED FROM "ONLINE" OR "SET UNIT CHARACTERISTICS" 
; PACKETS 

r 

X.UNSZ:'L'.BLKW 2 ;UNIT SIZE 

X.VSER:'L'.BLKW 2 ;VOLUME SERIAL NUMBER 


END 


X.DUSZ ='B 1 . 


? SIZE OF DISK MSCP CONTROLLER UCB EXTENTION 


.IF NB TTDEF 


; TERMINAL DRIVER DEFINITIONS 
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.=U.BUF 


U.TAPR: 

'L' 



U.TUX: 1 

L' 

.BLKW 1 


U.TSTA: 

'L' 

.BLKW 

4 

U.UIC: 1 

L 1 

.BLKW 1 


U.TFRQ: 

* L ' 

.BLKW 

1 

U.TFLK: 

'L' 

.BLKW 

1 

U.TCHP: 

1 L 1 

.BLKB 

1 

U.TCVP: 

’L' 

.BLKB 

1 

U.TTYP: 

1 L 1 

.BLKB 

1 

U.TMTI: 

'L' 

.BLKB 

1 

U.TTAB: 

1 L 1 

.BLKW 

1 


. = .-2 

U.TECO:'L' .BLKB 1 

U.TBSZ:'L' .BLKB 1 
U.TLPP:'L' .BLKW 1 
U.TST5:'L' .BLKW 1 
U.TST6:'L' .BLKW 1 
U.TIXL:'L' .BLKW 1 
U.ACB:'L' .BLKW 1 
U.AFLG:'L' .BLKW 1 
U.ADMA:'L' .BLKW 1 


APR VALUE FOR START OF UCBX 
POINTER TO UCB EXTENSION (UCBX) 

STATUS QUADRUPLE-WORD 
DEFAULT UIC 
FORK REQUEST WORD 
FORK LIST LINK WORD 
CURRENT HORIZONTAL POSITION 
CURRENT VERTICAL POSITION 
TERMINAL TYPE 
MODEM TIMER 

IF 0: U.TTAB+1 IS SINGLE-CHARACTER TYPE-AHEAD 
BUFFER, CURRENTLY EMPTY 

IF ODD: U.TTAB+1 IS SINGLE-CHARACTER TYPE-AHEAD 
BUFFER AND HOLDS A CHARACTER 
IF NON-O AND EVEN: POINTER TO MULT I-CHARACTER 
TYPE-AHEAD BUFFER 

THE NEXT TWO OFFSETS OVERLAP U.TTAB WHEN THE 

TYPEAHEAD BUFFER IS IN SECONDARY POOL 

ECHO BUFFER FOR DMA OPERATIONS WHEN UCBX IS 

IN SECONDARY POOL AND THUS NOT MAPPED BY A UMR 

TYPEAHEAD BUFFER SIZE 

LINES PER PAGE 

ADDITIONAL STATUS BITS 

EXTENDED I/O STATUS WORD 

I/O PACKET EXTENSION LISTHEAD 

ANCILLARY CONTROL DRIVER BLOCK ADDR 

ANCILLARY CONTROL DRIVER FLAGS WORD 

ANCILLARY CONTROL DRIVER DMA BUFFER 


.IF DF T$$LTH 


LAT Host Support 

;STATUS/CONTROL INFORMATION 


U.LINS: 

'L' 

.BLKB 

1 

;LINK STATUS 

U.CREN: 

'L' 

.BLKB 

1 

;TRANSMIT CREDITS COUNTER 
;SERVER/CIRCUIT IDENTIFICATION 

U.SRVN: 

'L' 

.BLKW 

1 

;SERVER NUMBER 

U.SESN: 

* L 1 

.BLKB 

1 

;SESSION NUMBER 

U.SLSZ: 

' L * 

.BLKB 

1 

;MAXIMUM SLOT SIZE ON XMT 
;PARAMETERS ON RECEIVE DATA 

U.RSBB: 

'L' 

.BLKW 

1 

;RECEIVE SLOT BIAS 

U.RBHA: 

* L * 

.BLKW 

1 

;RECEIVE SLOT HEADER VIRTUAL 

U.RSDV: 

1 L ' 

.BLKW 

1 

;RECEIVE DATA VIRTUAL 
;XMT INTERMEDIATE BUFFER CHAIN 

U.TRLH: 

1 L ' 

.BLKW 

1 

;XMT LISTHEAD ADDRESS 

U.TRSC: 

'L' 

.BLKW 

1 

;XMT REMAINED BYTES IN BUFFER 
;VIRTUAL CIRCUIT CCB 

U.CCBA: 

'L' 

.BLKW 

1 

;CCB ADDRESS (IN POOL) 


; LINK STATUS WORD IN U.LINS 

UL.TRS='B'l ;1-XMT STOPPED, O-NOT 

;>255 CHAR. FOR SLOT. HOLD IT. 
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UL.TDA='B'2 

UL.LST='B'4 

UL.RDA='B'10 
UL.ECH='B'20 
UL.RSS='B'100 

UL.LEN='B'200 

.ENDC ; .IF DF T$$LTH 


1-XMT DATA AVAIL, O-NOT 
DATA IN XMT QUEUE (SET BY PORT) 
1-LINE STOPPED, O-NOT 
LINE STOPPED BY USER (XOFF 
CAME FROM REMOTE TERMINAL) 

1-RCV DATA AVAIL, O-NOT 

DATA IN RCV QUEUE (SET BY PROC) 

BUFFER ALLOCATION FAILURE 

FOR 1 ECHO CHARACTER 

1-RCV STOPPED, O-NOT 

RCV STOPPED BY TTDRV ON RECEIVE 

IF NO RESOURCES AVAILABLE 

1-LINK ENABLE, O-NOT 

TOGGLED BY START/STOP LINK CALL 


DEFINE BITS IN STATUS WORD 1 (U.TSTA) 


INPUT STATUS 


SI.RST= 1 B'1 
S1.ESC= 'B ' 2 
SI.RSP= 'B ' 4 
SI.PTH='B ' 10 
SI.RNE='B ' 20 
S1.TSY='B ' 40 
SI.OB Y='B'10 0 
SI.IBY='B'200 
SI.DPR='B'400 
SI.DEC='B'1000 
SI.IBF= 1 B'2000 
S1.DSI='B'4000 
SI.RES='B'10000 

SI.RNF='B'20000 

SI.TNE='B'40000 
SI.USI='B'100000 


READ WITH SPECIAL TERMINATORS IN PROGRESS 

ESCAPE SEQUENCE IN PROGRESS 

READ WITH SPECIAL PROCESSING 

PASS THRU IS CURRENTLY ACTIVE 

ECHO SUPPRESSED 

TERMINAL OUTPUT SYNC IS CURRENTLY ENABLED 
OUTPUT BUSY 
INPUT BUSY 

DEFER PROCESSING OF CHAR. IN U.TECB 
DEFER ECHO OF CHAR. IN U.TECB 
BUFFERED INPUT IN PROGRESS 
INPUT PROCESSING DISABLED 

ESC. SEQ PROCESSING IS ENABLED FOR THE CURRENT 
READ 

READ NO FILTER IS ACTIVE (EDIT CHARACTERS ARE 
DISPLAYED) 

TERMINATOR NO ECHO 
UNSOLICITED INPUT IN PROGRESS 


DEFINE BITS IN STATUS WORD 2 (U.TSTA+2) 
OUTPUT STATUS 


S2.RCU='B'l 
S 2.WRA ='B'6 
S2.WRB='B'2 
S 2.WAL='B'10 
S2.BRQ='B'20 
S 2.SRQ='B'40 

S2.ORQ='B'100 
S2.IRQ='B'200 
S2.FLF=’B'400 
S2.ELF= 1 B'1000 
S2.CR='B'2000 
S2.OBF='B'4000 


;RESTORE CURSOR (MUST = TF.RCU) 

;CONTEXT FOR WRAP-AROUND 
;LOW BIT IN S2.WRA BIT PATTERN 
JWRITE PASS ALL (MUST = TF.WAL) 

;BREAK-THROUGH-WRITE REQUEST IN QUEUE 
;SPECIAL REQUEST IN QUEUE 
;(IO.ATT, IO.DET, SF.SMC) 

;OUTPUT REQUEST IN QUEUE (MUST = Sl.OBY) 

;INPUT REQUEST IN QUEUE (MUST = Sl.IBY) 

;FORCE LINEFEED BEFORE NEXT ECHO 

}EAT A LINEFEED (IGNORE A LEADING LF ON OUTPUT) 
;TRAILING CR REQUIRED ON OUTPUT 
;BUFFERED OUTPUT IN PROGRESS 
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S 2.PCU ='B 1 10 0 0 0 
S2.BEL='B'20000 
S2.CTO='B'40000 
S2.CTS='B'100000 


;POSITION CURSOR BEFORE WRITE 
;BELL PENDING 

;OUTPUT STOPPED BY CTRL-0 266. 
;OUTPUT STOPPED BY CTRL-S 


DEFINE BITS IN STATUS WORD 3 (U.TSTA+4) 


TERMINAL OPERATION CHARACTERISTICS 


S3.ACR='B 1 1 
S3.TAB='B'2 
S3.CTC='B'4 
S3.RAL='B'10 
S3.NEC='B'20 
S 3.TSY='B'40 
S3.8BC='B'100 
S3.FDX='B'200 
S3.MHE='B'400 
S3.ICE='B 1 1000 
S3.TME='B'2000 
S3.PTH='B'4000 
S3.RES='B'10000 
S3.PPT='B'20000 
S3.RUB='B'40000 


WRAP-AROUND (AUTOMATIC CR-LF) REQUIRED 

TYPE-AHEAD BUFFER ALLOCATION REQUESTED 

TERMINAL WANTS CLI TO HAVE ~C NOTIFICATION 

TERMINAL IS IN READ-PASS-ALL MODE 

NO ECHO 

TERMINAL SYNC 

PASS 8 BITS ON INPUT 

LINE IS IN FULL DUPLEX MODE 

NOTIFY ATTACHED TASK OF MODEM HANG-UP 

INPUT COUNT STATE ENABLED 

TERMINAL MANAGEMENT MODE ENABLED 

PASS THROUGH REQUESTED 

TASK WANTS ESCAPE SEQUENCES 

TERMINAL HAS PRINTER PORT 

RUBOUT SEQUENCE IN PROGRESS (NON-SCOPE) 


DEFINE BITS IN STATUS WORD 4 (U.TSTA+6) 


TERMINAL ATTRIBUTE CHARACTERISTICS 


S4.HFL='B'7 
S4.VFL='B'10 
S4.HFF='B'20 
S4.HHT=’B'40 
S4.DLO='B'100 
S4.HSY= 1 B 1 200 
S4.ANI= 1 B 1 400 
S4.AVO='B'1000 
S4.BLK='B'2000 
S 4.DEC='B 1 4000 
S4.EDT='B'10000 
S 4 . RGS = ' B ' 2 0 0 0 0 
S4.SFC='B'40000 
S 4.ABD='B'100000 


HORIZONTAL FILL REQUIREMENT 
VERTICAL FILL REQUIREMENT 
HARDWARE FORM-FEED PRESENT 
HARDWARE HORIZONTAL TAB PRESENT 
DIAL-OUT LINE (IMPLIES U2.RMT) 

HOST/TERMINAL SYNCHRONIZATION ENABLED (1=YES) 

ANSI CRT TERMINAL 

VT100-FAMILY TERMINAL DISPLAY 

BLOCK MODE TERMINAL 

DIGITAL CRT TERMINAL 

TERMINAL HAS LOCAL EDITING FUNCTIONS 
TERMINAL SUPPORTS REGIS GRAPHICS 
TERMINAL SUPPORTS SOFT CHARACTERS (DRCS) 
AUTO-BAUD SPEED DETECTION ENABLED 


DEFINE BITS IN STATUS WORD U.TST5 
ADDITIONAL STATUS CHARACTERISTICS 


S5.SWl='B'l 

S 5.TMM ='B'2 
S 5.XOF= 1 B'4 
S5.XON='B'10 
S5.HPC='B'14 


;FIRST TERMINAL MANAGEMENT SWITCH 

;CHARACTER HAS BEEN SEEN 

;TERMINAL IN TERMINAL MANAGEMENT MODE 

;SEND AN XOFF AT FIRST OPPORTUNITY 

;SEND AN XON AT FIRST OPPORTUNITY 

;OUTPUT OF HIGH PRIORITY CHARACTERS REQUESTED 
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S5.HPO='B'20 
S5.OXF='B'40 
S5.ITI='B'100 


;HIGH PRIORITY OUTPUT IN PROGRESS 
;XOFF HAS BEEN OUTPUT 
;IMMEDIATE TIMEOUT ON INPUT 


S5.RPO='B 1 2000 
S 5.VER='B'10000 

S5.BCC='B’20000 

S5.DAO='B'40000 


S5.ABP='B'100000 


;READ W/PROMPT OUTPUT IN PROGRESS 
;LAST CHAR. IN TYPE-AHEAD BUFFER 
;HAS PARITY ERROR 

;LAST CHAR. IN TYPE-AHEAD BUFFER 
;HAS FRAMING ERROR 
;LAST CHAR. IN TYPE-AHEAD BUFFER 
;HAS DATA OVERRUN ERROR 

;NOTE - THE 3 BITS ABOVE MUST CORRESPOND 
;TO THE RESPECTIVE ERROR FLAGS IN THE 
;HARDWARE RECEIVE BUFFER 
;AUTO-BAUD SPEED DETECTION IN PROGRESS 


DEFINE BITS IN EXTENDED I/O STATUS WORD U.TST6 


S6.EIO='B'400 
S 6.RLU='B'1000 
S6.RDI='B'100000 


;READ WAS AN EXTENDED I/O 

;READ WITH LOWER CASE TO UPPER CASE CONVERSION 
;READ WITH DEFAULT INPUT 


. ENDC 


VIRTUAL TERMINAL UCB DEFINITIONS 


.=U.UNIT 

U.OCNT:'L'.BLKB 1 
.=U.BUF 

U.RPKT:'L'.BLKW 1 
U.WPKT:'L'.BLKW 1 
U.IAST:'L'.BLKW 1 
U.OAST:'L'.BLKW 1 
U.AAST:'L'.BLKW 1 


.IF NB TTDEF 

.IIF NE U.AAST+2-U.UIC .ERROR ;ADJACENCY ASSUMED 
.ENDC 


.=U.AAST+4 

U.PTCB:'L'.BLKW 1 ;PARENT TCB ADDRESS 


CONSOLE DRIVER DEFINITIONS 


jOFFSPRING WITH THIS AS TI: 

;CURRENT OFFSPRING READ I/O PACKET 
;CURRENT OFFSPRING WRITE I/O PACKET 
;INPUT AST ROUTINE ADDRESS 
;OUTPUT AST ROUTINE ADDRESS 
;ATTACH AST ROUTINE ADDRESS 


. =U.BUF+2 

U.CTCB:'L' .BLKW 1 
U.COTQ:'L' .BLKW 2 
U.RED2:'L' .BLKW 1 


;ADDRESS OF CONSOLE LOGGER TCB 
;I/O PACKET LIST QUEUE 
;REDIRECT UCB ADDRESS 


C-82 











RSX-11M-PLUS SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS 


UCBDF$ (Cont.) 


.PSECT 


+ 

DEVICE TABLE STATUS DEFINITIONS 


DEVICE CHARACTERISTICS WORD 1 (U.CW1) DEVICE TYPE DEFINITION BITS. 


DV.REC='B’l 
DV.CCL='B'2 
DV.TTY='B'4 
DV.DIR='B'10 
DV.SDI='B'20 
DV.SQD='B'40 
DV.MSD='B'100 
DV.UMD='B'200 
DV.MBC='B'400 
DV.EXT='B'400 
DV.SWL='B'1000 
DV.ISP='B'2000 
DV.OSP='B'4000 
DV.PSE='B 1 10000 
DV.COM='B'20000 
DV.Fll='B'40000 
DV.MNT='B'100000 


RECORD ORIENTED DEVICE (1=YES) 

CARRIAGE CONTROL DEVICE (1=YES) 

TERMINAL DEVICE (1=YES) 

FILE STRUCTURED DEVICE (1=YES) 

SINGLE DIRECTORY DEVICE (1=YES) 

SEQUENTIAL DEVICE (1=YES) 

MASS STORAGE DEVICE (1=YES) 

USER MODE DIAGNOSTICS SUPPORTED (1=YES) 

MASSBUS CONTROLLER (11M COMPATIBILITY ONLY) 

UNIT ON EXTENDED 22-BIT UNIBUS CNTROLER (1=YES) 
UNIT SOFTWARE WRITE LOCKED (1=YES) 

INPUT SPOOLED DEVICE (1=YES) 

OUTPUT SPOOLED DEVICE (1=YES) 

PSEUDO DEVICE (1=YES) 

DEVICE IS MOUNTABLE AS COM CHANNEL (1=YES) 
DEVICE IS MOUNTABLE AS Fll DEVICE (1=YES) 

DEVICE IS MOUNTABLE (1=YES) 


+ 

TERMINAL DEPENDENT CHARACTERISTICS WORD 2 (U.CW2) BIT DEFINITIONS 


U2.DH1='B'100000 
U2.DJ1='B'40000 
U2.RMT='B'20000 
U2.HFF= 1 B'10000 
U2.L8S='B'10000 
U2.NEC='B'4000 
U2.CRT='B 1 2000 
U2.ESC='B'1000 
U2.LOG='B'400 
U2.SLV=’B'200 
U2.DZ1='B'100 
U2.HLD='B'40 
U2.AT.='B'20 
U 2.PRV='B'10 
U2.L3S='B ' 4 
U2.VT5='B'2 
U 2.LWC ='B ' 1 


UNIT IS A MULTIPLEXER (1=YES) 

UNIT IS A DJ11 (1=YES) 

UNIT IS REMOTE (1=YES) 

UNIT HANDLES HARDWARE FORM FEEDS (1=YES) 

OLD NAME FOR U2.HFF 

DON'T ECHO SOLICITED INPUT (1=YES) 

UNIT IS A CRT (1=YES) 

UNIT GENERATES ESCAPE SEQUENCES (1=YES) 

USER LOGGED ON TERMINAL (0=YES) 

UNIT IS A SLAVE TERMINAL (1=YES) 

UNIT IS A DZ11 (1=YES) 

TERMINAL IS IN HOLD SCREEN MODE (1=YES) 

MCR COMMAND AT. BEING PROCESSED (1=YES) 

UNIT IS A PRIVILEGED TERMINAL (1=YES) 

UNIT IS A LA30S TERMINAL (1=YES) 

UNIT IS A VT05B TERMINAL (1=YES) 

LOWER CASE TO UPPER CASE CONVERSION (0=YES) 


+ 

BIT DEFINITIONS FOR U.MUP 
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UM.OVR='B'1 
UM.CLI='B'36 
UM.DSB='B'200 
UM.NBR='B'400 
UM.CNT= 'B ' 1000 
UM.CMD='B'2000 
UM. SER= 'B 1 4000 
UM.KIL='B'10000 


;OVERRIDE CLI INDICATOR 
;CLI INDICATOR BITS 

;TERMINAL DISABLED SINCE CLI ELIMINATED 
;NO BROADCAST 

CONTINUATION LINE IN PROGRESS 
COMMAND IN PROGRESS 

;SERIAL COMMAND RECOGNITION ENABLED 
;TTDRV SHOULD SEND KILL PKT ON CNTRL/C 


; + 

; RHI1-RS03/RS04 CHARACTERISTICS WORD. 2 (U.CW2) BIT DEFINITIONS 
U2.R04='B'100000 ;UNIT IS A RS04 (1=YES) 

; + 

; RH11-TU16 CHARACTERISTICS WORD 2 (U.CW2) BIT DEFINITIONS 


U2.7CH='B'10000 ;UNIT IS A 7 CHANNEL DRIVE (1=YES) 

; + 

; TERMINAL DEPENDENT CHARACTERISTICS WORD 3 (U.CW3) BIT DEFINITIONS 


U3.UPC='B'20000 ;UPCASE OUTPUT FLAG 

U3.PAR='B'40000 ;PARITY GENERATION AND CHECKING 

U3.0PA='B'100000 ;PARITY SENSE (l=ODD PARITY) 

; + 

; VIRTUAL TERMINAL 3RD CHARACTERISTICS WORD DEFINITIONS 


U3.FDX='B'1 ;FULL DUPLEX MODE (1=YES) 

U3.DBF='B'2 ;INTERMEDIATE BUFFERING DISABLED (1=YES) 

U3.RPR='B'4 ;READ W/PROMPT IN PROGRESS (1=YES) 

; + 

; TERMINAL DEPENDENT CHARACTERISTICS WORD 4 (U.CW4) BIT DEFINITIONS 


U4.CR='B'100 ;LOOK FOR CARRIAGE RETURN 


UNIT CONTROL PROCESSING FLAG DEFINITIONS 


UC. ALG= 'B'200 
UC.NPR=’B'100 
UC.QUE='B'40 
UC . PWF = 1 B ' 2 0 
UC. ATT= 'B'10 
UC.KIL='B’4 
UC. LGH= 'B ' 3 

; + 

; UNIT STATUS BIT DEFINTIONS 


;BYTE ALIGNMENT ALLOWED (l=NO) 

;DEVICE IS AN NPR DEVICE (1=YES) 

;CALL DRIVER BEFORE QUEUING (1=YES) 

;CALL DRIVER AT POWERFAIL ALWAYS (1=YES) 
;CALL DRIVER ON ATTACH/DETACH (1=YES) 
;CALL DRIVER AT I/O KILL ALWAYS (1=YES) 

;TRANSFER LENGTH MASK BITS 
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US.BSY='B'200 
US.MNT='B'100 
US.FOR='B'40 
US.MDM='B'20 
US.PWF='B 1 10 

; + 

; CARD READER DEPENDENT 


; UNIT 

IS 

BUSY (1 

=ye: 

; UNIT 

IS 

MOUNTED 

(0 

; UNIT 

IS 

MOUNTED 

AS 

; UNIT 

IS 

MARKED 

FOR 


;POWERFAIL OCCURED 

STATUS BIT DEFINITIONS 


i) 

: YES) 

FOREIGN VOLUME (1=YES) 
DISMOUNT (1=YES) 

1=YES) . 


US.ABO='B'l ;UNIT IS MARKED FOR ABORT IF NOT READY (1=YES) 

US.MDE='B'2 ;UNIT IS IN 029 TRANSLATION NODE (1=YES) 

; + 

; FILES-11 DEPENDENT UNIT STATUS BITS 


US.WCK='B'10 ;WRITE CHECK ENABLED (1=YES) 
US.SPU='B 1 2 ;UNIT IS SPINNING UP (1=YES) 
US.VV= 1 B 1 1 ;VOLUME VALID IS SET (1=YES) 


TERMINAL DEPENDENT UNIT STATUS BIT DEFINITIONS 


US.CRW='B'4 
US.DSB='B'2 
US.OIU='B'l 


LPS11 DEPENDENT UNIT STATUS BIT DEFINITIONS 


US.FRK='B'2 
US.SHR='B'1 


; ANSI MAGTAPE DEPENDENT UNIT STATUS BITS 

US.LAB='B 1 4 ; UNIT HAS LABELED TAPE ON IT (1=YES) 


UNIT STATUS EXTENSION (U.ST2) BIT DEFINITIONS 


;FORK IN PROGRESS (1=YES) 

;SHAREABLE FUNCTION IN PROGRESS (0='B'YES) 


;UNIT IS WAITING FOR CARRIER (1=YES) 

;UNIT IS DISABLED (1=YES) 

;OUTPUT INTERRUPT IS UNEXPECTED ON UNIT (1=YES) 


US.OFL='B'1 
US.RED= 1 B'2 
US.PUB='B 1 4 
US.UMD='B 1 10 
US.PDF='B'20 
US.MUN='B'40 
US.TRN='B'100 
US.SIO='B'200 


;UNIT OFFLINE (1=YES) 

;UNIT REDIRECTABLE (0=YES) 

;UNIT IS PUBLIC DEVICE (1=YES) 

;UNIT ATTACHED FOR DIAGNOSTICS (1=YES) 

;PRIVILEGED DIAGNOSTIC FUNCTIONS ONLY (1=YES) 
;MULTI-UNIT FLAG 

;UNIT TRANSITION HAS OCCURRED (1=YES) 

;STALL I/O TO UNIT (1=YES) 


MAGTAPE DENSITY SUPPORT DEFINITION IN U.CW3 
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UD.UNS='B'0 

; UNSUPPORTED 

UD. 200= 'B 1 1 

; 200BPI, 

7 TRACK 

UD. 556= *B ' 2 

; 556BPI, 

7 TRACK 

UD. 800='B 1 3 

; 800BPI, 

7 OR 9 TRACK 

UD.160= *B ' 4 

;1600BPI, 

9 TRACK 

UD. 625= *B 1 5 

;6250BPI, 

9 TRACK 

UD.8K= 1 B'6 

;8K BPI - 

SERIAL, SERPENTINE 


.MACRO UCBDF$,X,Y,Z , A 
. ENDM 
. ENDM 


RECORDING. 
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APPENDIX D 


MICRO/RSX COMMON ERROR CODE DEFINITIONS 


This appendix lists: 

1. Facility-independent error code definitions 

2. Standard Bugcheck formats for facility-defined error codes 


Common (Facility-Independent) Error Code Definitions 


SST-Type Errors - Error Code 1 


BE.ODD = 000100 


BE.SGF = 000102 
BE.BPT = 000104 
BE.IOT = 000106 
BE.ILI = 000110 
BE.EMT = 000112 
BE.TRP = 000114 
BE.STK = 000116 


Odd address or other trap four 

Segment fault 

Breakpoint or T-bit trap 

IOT instruction 

Illegal instruction 

EMT instruction 

Trap instruction 

Stack overflow 


Internal Inconsistency Errors - Error Code 2 


BE.NPA 
BE.SGN 
BE.2FR 
BE.ISR 
BE.FHW 
BE.CSR 
BE.IDC 
BE.ACP 
BE.HSP 
BE.NCT 


000200 

000201 

000202 

000203 

000204 

000205 

000206 

000207 

000210 

000211 


Task with no parent aborted 
Feature not included in system 
Double fork 

Interrupt service routine clobbered register 

Fatal hardware error 

Device CSR disappeared 

Internal database consistency error 

ACP task aborted 

Header subpacket problem 

No current task 


System Pool Related Errors - Error Code 3 


BE.NPL = 000300 
BE.DDA = 000301 
BE.SIZ = 000302 
BE.BAK = 000303 
BE.POV = 000304 


; No pool for operation 
; Double deallocation 
; Size of block invalid 
; Deallocated block below pool 
; Deallocation overlaps end of pool 


Group-global Event Flag Errors - Error code 4 


BE.GGF = 000400 


Task locked to non-existent flags 
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Standard Bugcheck Format Facility Code Definitions 


I/O Driver Subsystem - Facility Code 2 


BF.TTD 

= 

000200 

Terminal driver 

r 


Executive Components 

- Facility Code 3 

BF.EXE 

= 

000300 

Exec 

_ 

General and miscellaneous 

BF.XDT 

= 

000301 

Exec 

- 

Executive Debugging Tool 

BF.POL 

= 

000303 

Exec 

- 

Pool handling routines (CORAL) 

BF.ERR 

= 

000304 

Exec 

- 

Hardware error processing subsystem 

BF.INT 

= 

000305 

Exec 

- 

Internal consistency checking routine 

BF.INI 

= 

000306 

Exec 

- 

INITL - initialization module 

BF.DVI 

= 

000307 

Exec 

- 

DVINT common interrupt handler 

BF.PAR 

= 

000310 

Exec 

- 

Parity memory support 

BF.XIT 

= 

000311 

Exec 

- 

Task exit/abort procesing 

BF.QIO 

= 

000312 

Exec 

- 

QIO directive 

BF•OPT 

= 

000313 

Exec 

- 

Seek optimization 

BF•ACC 

= 

000314 

Exec 

- 

System resource accounting 

BF.KAS 

= 

000315 

Exec 

- 

Kernel AST support 

BF.DIR 

= 

000316 

Exec 

- 

Miscellaneous directives 

BF.SAN 

= 

000317 

Exec 

- 

Crash with sanity timer message 
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ABODF$, B-3, C-3 
ACNDF$, C-5 
/ACT, 2-4, 2-5 
Active task 

address of TCB, 3-21 
AST queue, 3-23 
attribute bits, 3-22 
blocking bits, 3-21 
MCR, 3-26 
name, 3-21 

Offspring Control Block, 3-23 
partition, 3-21 
receive queue, 3-23 
receive-by-reference queue, 

3-24 

state bits, 3-22 
task image, 3-21 
Active task dump, 3-21 
AST queue, 3-21 
Offspring Control Block, 3-21 
receive queue, 3-21 
receive-by-reference queue, 

3-21 

/ADV, 2-4, 2-5 
/ALL, 2-4, 2-5 
All devices switch 
See /ADV 

Analysis listings, 3-1 to 3-57 
interpreting, 4-1 
Analysis routines switch 
See /ALL 

Analysis switches, 2-3 to 2-7 
ANALYZE/CRASH_DUMP command, 1-8 
error messages, A-l 
examples, 2-21 
format, 2-11 
input to, 2-12 
qualifiers, 2-12 to 2-21 
specification, 2-12 
Assign table dump, 3-1, 3-17 
logical device names, 3-17 
physical device names, 3-17 
/ATL, 2-4, 2-5 

Binary output file size switch 
See /MEMSIZ 
/BL, 2-8 

Block number switch 
See /BL 

Bugcheck facility, 1-5 

error code definitions, D-l 

CDA 

analysis listing, 1-1, 1-6, 1-8, 
3-1 to 3-57 

See also Analysis listings 
function, 1-1 
generating, 1-1 
input to, 1-1, 1-3 
messages, A-l 


CDA (Cont.) 
running, 1-7 

as installed task, 1-7 
as uninstalled task, 1-8 
switches, 2-3 to 2-11 
system requirements, 1-1 
CDA command line, 2-1 to 2-11 
binary file, 2-2 
crash input file, 2-3 
default, 2-10 
format, 2-1 

in indirect command file, 1-8 
list file, 2-1 
symbol file, 2-2 
/CLI, 2-4, 2-6 
CLI parser block dump, 3-31 
CLKDF$, B-4, C-12 
Clock queue dump, 3-50 
Clock queue switch 
See /CLQ 
/CLQ, 2-4, 2-6 

Command line interpreter switch 
See /CLI, /CPB 

Common Block Directory dump, 3-36 
/CPB, 2-4, 2-6 
Crash 
cause 

determining, 4-1 
HALT instruction, 1-2 
infinite loop, 1-2 
processor trap, 1-2 
restart procedure, 1-3 
dump 

obtaining, 1-2 
Crash Dump Analyzer 
See CDA 

Crash dump binary file, 1-3, 1-6, 
2-2 

Crash dump device, 1-1, 1-3 
and drivers, 1-4 
changing, 1-4 
displaying, 1-5 
restrictions, 1-2 
specifying, 1-4, 1-5, 2-2 
valid for Micro/RSX system, 1-2 
valid for pregenerated 

RSX-11M-PLUS system, 1-2 
valid for RSX-11M/M-PLUS system, 
1-2 

Crash dump driver 
and devices, 1-4 
loadable, 1-1, 1-3 to 1-7 
loading, 1-4 
unloading, 1-5 
Crash dump listing 

See also Analysis listings 
interpreting, 4-1 to 4-3 
mapping data, 4-1 
stack depth, 4-2 
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Crash dump routine 

See Executive crash dump 
routine 

Crash notification device, 1-1, 

1-2, 1-3 

$CRAVL, 3-15, 3-45 
CTBDF$, C-14 
/CTL, 2-5, 2-6 
Current task priority 
pointer to, 3-20 

/DCB, 2-5, 2-6 
DCBDF$, B-6, C-15 
/DENS, 2-8 
/DEV, 2-5, 2-6 
Device 

crash dump, 1-1 

crash notification, 1-1 

See also Crash notification 
device 

fixed media, 1-3, 1-5 
invalid crash dump, 1-3, 1-5 
switches, 2-6 
system, 1-5 
unit number, 1-4 
valid crash dump, 1-2, 1-5 
Device controller dump, 3-51 
common interrupt address, 3-51 
Controller Request Block, 3-52 
controller status, 3-52 
Controller Table, 3-51 
Device controller switch 
See /CTL 

Device information dump, 3-38 
control processing flags, 3-39 
device characteristics word, 

3-39 

Device Control Block, 3-42 
I/O request packet, 3-42 
Status Control Block, 3-42 
terminal status word, 3-38 
UCB extension, 3-42 
Device names 
logical, 3-17 
physical, 3-17 
/DMP, 2-5, 2-6 
/DUMP, 2-5, 2-6 

EPKDF$, B-13, C-17 
Error code definitions, D-l 
Error log buffer 
address of, 3-19 

Error log packet dump, 1-9, 3-1, 
3-19 

Error messages, A-l 

EVNDF$, B-14, C-25 

Executive crash dump routine, 1-1, 

1- 2, 1-3 
building, 1-1 

Executive Debugging Tool 
See XDT 

Executive symbol table, 1-1, 2-2, 

2- 15 


Executive symbol table (Cont.) 
switch 

See /STB 
/EXIT, 2-8, 2-9 
Exit switch 
See /EXIT 

F11DF$, C-2 8 
F11TBL$, B-17 

Function switches, 2-7 to 2-10 

Group-global event flag dump, 1- 

3-1, 3-18 

/HDR, 2-5, 2-6 
HDRDF, C-33 
HDRDF$, B-21 
HWDDF$, B-23, C-35 

ITBDF$, B-26 

/KDS, 2-5, 2-6 
Kernel data space 
dump, 3-53 
switch 
See /KDS 

Kernel instruction space 
dump, 3-53 
switch 
See /KIS 

Kernel Mapping Register switch 
See /KMR 

Kernel stack dump, 3-1, 3-5 
/KIS, 2-5, 2-6 
/KMR, 2-8, 2-9 
KRBDF$, C-41 

LCBDF$, B-27, C-43 
/LIMIT, 2-8, 2-9 
/LINES, 2-8, 2-9 
Lines per page switch 
See /LINES 

Loadable crash dump driver 
See Crash dump driver 
Logical device assignments, 3-17 
Logical device names, 3-17 
Low core memory 

dump, 1-9, 3-1, 3-20 
labels, 3-20 

MCR Unit Control Block, 3-26 
/MEMSIZ, 2-8, 2-9 
Micro/RSX 

Advanced Programmer’s Kit, 1-1 
1-3 

MTADF$, B-28, C-44 

No spool switch 
See /-SP 

Offset mode, 3-1 
OLRDF$, C-47 

Output listing limit switch 
See /LIMIT 
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/PAR, 2-5, 2-7 
Partition 

base address, 3-21 
name, 3-21 
PCB address, 3-21 
status flags, 3-33 
Partition Control Block, 3-33 
address, 3-31 
pointer to, 3-33 
switch 

See /PCB, /PAR 
Partition information dump 
attachment descriptor, 3-34 
individual, 3-33 
system, 3-31 
wait queue, 3-34 
/PCB, 2-5, 2-7 
PCBDF$, B-31, C-55 
Physical device names, 3-17 
Physical memory switch 
See /DUMP 
$PKAVL, 3-45 
PKTDF$, B-33, C-60 
/POOL, 2-5, 2-7 
Pool 

bit map, 3-15 
dump, 3-45 
free, 3-15 

largest fragment, 3-15 
number of unallocated fragments, 
3-15 

secondary pool dump, 3-45 
size, 3-15 

smallest possible block, 3-15 
total free bytes, 3-15 
Pool statistics dump, 3-1, 3-15 
Processor Status Word, 3-2 
Program Counter, 3-2 

Qualifiers 

command, 2-12 to 2-15 
crash-input, 2-15 to 2-21 

Register 

cache control, 3-3 

error, 3-2 

general, 3-2 

memory management, 3-2 

memory system error, 3-2 

page 

address, 3-2 
description, 3-2 
UNIBUS mapping, 3-2 
volatile, 3-1, 3-3 

See also Volatile registers 
Relative addresses, 3-1 
RSX11M.STB 

See Executive symbol table 

Saved stack pointer, 3-20 
/SCB, 2-5, 2-6 
SCBDF$, B-39, C-66 
Secondary pool 
dump, 3-45 


Secondary pool (Cont.) 
switch 

See /SECPOOL 
/SECPOOL, 2-7 
SHDDF$, C-69 
/-SP, 2-8, 2-10 
Stack pointer 

kernel, 3-2, 3-5 
user, 3-2 

/STB, 2-2, 2-8, 2-10 
/STD, 2-5, 2-7 
$STKDP, 4-2 
Switches 

analysis, 2-3 to 2-7 
function, 2-7 to 2-10 
/-SYS, 2-5, 2-7 
System 

device, 1-5 
switches, 2-6 
generation 
and CDA, 1-1 
information, 3-1 
switch 

See /-SYS 

information dump, 1-8 
pool 

dump, 3-45 
switch 

See /POOL 
requirements, 1-1 
System common, 3-6 
active task, 3-6 
alphabetized dump, 3-1, 3-9 
boot device, 3-6 
dump 

See System common dump 
labels, 3-9 to 3-14 
network UIC, 3-6 
partition address, 3-6 
stack depth, 3-6 
system size, 3-6 
TCB address, 3-6 
UIC, 3-6 

System common dump, 3-1, 3-9 to 
3-14 

stack depth indicator, 4-2 
System Task Directory 
dump, 3-44 
switch 
See /STD 

/TAL, 2-5, 2-7 
Tape density switch 
See /DENS 
/TAS, 2-5, 2-7 
/TASK, 2-5, 2-7 
Task Control Block switch 
See /ACT, /ATL 
Task data space 
dump, 3-53 
switch 

See /TDS 
Task dump, 3-48 

window blocks, 3-48 
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Task header 

pointer to, 3-20 
switch 
See /HDR 

Task header dump, 3-28 

Directive Status Word, 3-28 
File Control Block, 3-29 
Logical Unit Table, 3-28 
Page Description Register, 
swapping priority, 3-28 
window blocks, 3-29 

Task instruction space 
dump, 3-53 
switch 
See /TIS 

Task virtual address space sw 
2-7 


/TCB, 2-5, 2-7 
TCB 

address of, 3-21, 3-24 
pointer to current, 3-20 
TCBDF$, B-41, C-71 
/TDS, 2-5, 2-7 
/TIS, 2-5, 2-7 
/TSK, 2-5, 2-7 
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/UCB, 2-5, 2-6 
UCBDF$, B-45, C-75 

Volatile registers, 3-1 
dump, 3-2 to 3-4 

tch, 

XDT, 1-2, 1-3, 1-6, 1-7 
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